bbmsp_contact_get_status_message()

Retrieve a contact's status message.

Synopsis:

#include <bbmsp/bbmsp_contactlist.h>
 
BBMSP_API bbmsp_result_t bbmsp_contact_get_status_message(const bbmsp_contact_t *contact, char *status_message, size_t status_message_buffer_size)

Since:

BlackBerry 10.0.0

Arguments:

contact

A pointer to the contact whose status message to get.

status_message

A buffer that will be updated with the status message encoded as UTF-8. The resulting buffer will be null-terminated on success.

status_message_buffer_size

The size of the status_message buffer. This should be BBMSP_CONTACT_STATUS_MSG_MAX.

Library:

libbbmsp (For the qcc command, use the -l bbmsp option to link against this library)

Description:

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.