navigator_invoke_timer_registration_set_id()

Assign request message ID the timer registration.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API int navigator_invoke_timer_registration_set_id(navigator_invoke_timer_registration_t *reg,
                                                       const char *id)

Since:

BlackBerry 10.3.0

Arguments:

reg

The navigator_invoke_timer_registration_t structure to modify.

id

The registration message ID to assign.

Library:

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

Description:

The navigator_invoke_timer_registration_set_id() function stores the message ID in the given navigator_invoke_timer_registration_t structure. The message ID is a required attribute when there is a need to verify the registration status. It is used for correlating with incoming registration response messages.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.