bps_get_domain

Retrieve domain-specific data from the active channel.

Synopsis:

#include <bps/bps.h>

BPS_API void* bps_get_domain_data(int domain_id)

Since:

BlackBerry 10.0.0

Arguments:

domain_id: The domain ID provided by the bps_register_domain() function.

Library:

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

Description:

A service calls this function when it needs to retrieve the user data that was previously provided to the channel using the bps_set_domain_data() function.

When no data is associated with the domain_id argument, a NULL value is returned.

Returns:

The user data that was associated with the active channel and the domain_id. If no data is found, a NULL value is returned.