/**
* @brief Deletes an activity record from the contacts database by contact ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] contact_id The contact ID to delete
/**
* @brief Deletes an activity record from the contacts database by account ID.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] account_id The account ID to delete
/**
* @brief Enumeration for contact DB status.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CONTACTS_DB_STATUS_NORMAL, /**< Normal */
/**
* @brief Gets the current status of server.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] status The current status of server
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Called when contacts-service server status changes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] status The current status of server
* @param[in] user_data The user data passed from the callback registration function
* @pre This function requires an open connection to contacts service by contacts_connect().
/**
* @brief Registers a callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success,
/**
* @brief Unregisters a callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] callback The callback function to register
* @param[in] user_data The user data to be passed to the callback function
* @return @c 0 on success,
/**
* @brief Adds a contact and a group relationship to the contacts database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] group_id The group ID
/**
* @brief Removes a contact and a group relationship from the contacts database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] group_id The group ID
/**
* @brief Sets a group between the previous group and the next group.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] group_id The group ID to move
/**
* @brief Creates a contacts list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks You must release @a contacts_list using contacts_list_destroy().
* @param[out] contacts_list The contacts list handle
* @return @c 0 on success,
/**
* @brief Destroys a contacts list and releases its all resources.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @param[in] delete_child Set @c true to destroy child records automatically,
* otherwise set @c false to not destroy child records automatically
/**
* @brief Retrieves the number of contact entities from a contacts list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @param[out] count The count of contact entity
* @return @c 0 on success,
/**
* @brief Adds a record to a contacts list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks Same kind of record can be added.
* @param[in] contacts_list The contacts list handle
* @param[in] record The record handle
* @brief Removes a record from the contacts list.
* @details If the record is current record, then current record is changed the next record. \n
* If the record is the last record, then current record will be @c NULL.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @param[in] record The record handle
* @return @c 0 on success,
/**
* @brief Retrieves a record from the contacts list.
* @details The default current record is the first record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks You MUST NOT destroy the @a record.
* It is destroyed automatically when the @a contacts_list is destroyed.
* @param[in] contacts_list The contacts list handle
/**
* @brief Moves a contacts list to the previous position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a contacts list to the next position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a contacts list to the first position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Moves a contacts list to the last position.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] contacts_list The contacts list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Links a person to another person.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] base_person_id The base person ID
/**
* @brief Unlinks a contact from a person.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] person_id The person ID
/**
* @brief Resets a person's usage count.
* @details The person is no longer in the most frequently contacted person list.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] person_id The person ID
/**
* @brief Sets the order of a (favorite) contact.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @param[in] person_id The person ID to move
/**
* @brief Enumeration for Contacts person properties.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CONTACTS_PERSON_PROPERTY_NAME_CONTACT, /**< Default contacts record */
/**
* @brief Sets a record's default property.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @remarks @a id can be contact_id, number_id, email_id, image_id.
/**
* @brief Gets a default property for a record.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
* @remarks @a id can be contact_id, number_id, email_id, image_id.
/**
* @brief Resets the phone log's count.
* @details The number of all types in the phone log will be @c 0.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/callhistory.write
* @return @c 0 on success,
/**
* @brief Connects to the contacts service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks Connection opening is necessary to access the contacts server such as fetching, inserting, or updating records.\n
* The execution of contacts_connect() and contacts_disconnect() could slow down your application. So it is not recommended to call them frequently.
* @return @c 0 on success,
/**
* @brief Disconnects from the contacts service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks If there is no opened connection, this function returns #CONTACTS_ERROR_DB.
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Connects to the contacts service with a connection on another thread.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks Opening connection is necessary to access the contact server and to perform operations such as fetching, inserting, or updating records.\n
* On multiple thread environment with contacts_connect(), request can be failed in one thread, while another request is working by the connection in the other thread.
* To prevent request fail, contacts_connect_on_thread() is recommended. Then new connection is set for the thread.
/**
* @brief Disconnects from the contacts service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @remarks If there is no opened connection, this function returns #CONTACTS_ERROR_DB.
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Definition for contacts_connect_with_flags(). If it is called the API with this flag, then retry to call contacts_connect() for several times.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @see contacts_connect_with_flags()
*/
#define CONTACTS_CONNECT_FLAG_RETRY 0x00000001
/**
* @brief Definition for default flag of contacts_connect_with_flags().
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @see contacts_connect_with_flags()
*/
#define CONTACTS_CONNECT_FLAG_NONE 0
/**
* @brief Connects to the contacts service.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.3
* @param[in] flags Connection flag
* @remarks Connection opening is necessary to access the contacts server such as fetching, inserting, or updating records.\n
* Before contacts-service daemon is ready, if you call contacts_connect(), it will fail.
/**
* @deprecated Deprecated since 3.0. Use contacts_sim_import_all_contacts_by_sim_slot_no() instead.
* @brief Imports all contacts from first SIM to Contacts Database.
- * @since_tizen @if MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.write
* @return @c 0 on success,
/**
* @deprecated Deprecated since 3.0. Use contacts_sim_get_initialization_status_by_sim_slot_no() instead.
* @brief Checks whether first SIM initialization is completed.
- * @since_tizen @if MOBILE 2.3 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/contact.read
* @param[out] completed @c true if SIM is initialized,