navigator_event_get_card_closed

Retrieve the data passed by the child card upon closure.

Synopsis:

#include <bps/navigator.h>

BPS_API const char* navigator_event_get_card_closed_data(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The NAVIGATOR_CHILD_CARD_CLOSED event that informed the parent application of the child card closure.

Library:

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

Description:

The navigator_event_get_card_closed_data() function extracts the data sent by the child card upon calling the navigator_card_close() function. Call this function in the parent application upon receiving a NAVIGATOR_CHILD_CARD_CLOSED event to retrieve the data in the child card's response message. This function doesn't copy data and the returned value is released once the bps_get_event() function is called again.

Returns:

The data passed from the child card upon success, NULL with errno set otherwise.