navigator_invoke_query_set_id()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_query_set_id(navigator_invoke_query_t *query,
                                          const char *id)

Since:

BlackBerry 10.0.0

Arguments:

query

A pointer to the navigator_invoke_query_t structure whose id you want to set.

id

The invocation query ID you want to display on the delivery receipt response. This value must be in numerical format. For example, a valid id would be "42".

Library:

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

Description:

The navigator_invoke_query_set_id() function sets the invocation query ID of a given navigator_invoke_query_t structure. Assign an id member to an invocation query to receive a delivery receipt response. The id member you assign through a sender appears in its corresponding delivery receipt.

Assigning an id member to an invocation is mandatory. If you don't assign an id, there is no way to determine the result of the invocation query request.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.