Tizen Native API  4.0

This provides APIs related to Place Contact, used in Place Discovery and Search.

Functions

int maps_place_contact_destroy (maps_place_contact_h contact)
 Destroys the place contact handle and releases all its resources.
int maps_place_contact_clone (const maps_place_contact_h origin, maps_place_contact_h *cloned)
 Clones the place contact handle.
int maps_place_contact_get_label (const maps_place_contact_h contact, char **label)
 Gets the place contact label.
int maps_place_contact_get_type (const maps_place_contact_h contact, char **type)
 Gets the place contact type.
int maps_place_contact_get_value (const maps_place_contact_h contact, char **value)
 Gets the place contact value.

Typedefs

typedef void * maps_place_contact_h
 The Place Contact handle.

Typedef Documentation

typedef void* maps_place_contact_h

The Place Contact handle.

The handle of Place Contact instance.

Since :
2.3.2
Remarks:
To release the handle use maps_place_contact_destroy().
To clone the handle use maps_place_contact_clone().
See also:
maps_place_contact_destroy()
maps_place_contact_clone()

Function Documentation

Clones the place contact handle.

This function clones the place contact handle origin and all its resources.

Since :
2.3.2
Remarks:
cloned must be released using maps_place_contact_destroy().
Parameters:
[in]originThe original place contact handle
[out]clonedA cloned place contact handle
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_OUT_OF_MEMORYOut of memory
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_contact_destroy()

Destroys the place contact handle and releases all its resources.

This function destroys the place contact handle and releases all its resources.

Since :
2.3.2
Parameters:
[in]contactThe place contact handle to destroy
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_contact_clone()
int maps_place_contact_get_label ( const maps_place_contact_h  contact,
char **  label 
)

Gets the place contact label.

This function gets the place contact label.

Since :
2.3.2
Remarks:
label must be released using free().
Parameters:
[in]contactThe handle to place contact
[out]labelThe place contact label
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_place_contact_get_type ( const maps_place_contact_h  contact,
char **  type 
)

Gets the place contact type.

This function gets the place contact type.

Since :
2.3.2
Remarks:
type must be released using free().
Parameters:
[in]contactThe handle to place contact
[out]typeThe place contact type
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_place_contact_get_value ( const maps_place_contact_h  contact,
char **  value 
)

Gets the place contact value.

This function gets the place contact value.

Since :
2.3.2
Remarks:
value must be released using free().
Parameters:
[in]contactThe handle to place contact
[out]valueThe place contact value
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported