locale_request_events()

Start receiving locale status change events.

Synopsis:

#include <bps/locale.h>

BPS_API int locale_request_events(int flags)

Since:

BlackBerry 10.0.0

Arguments:

flags: The types of events to deliver. A value of zero indicates that all events are requested. The meaning of non-zero values is reserved for future use.

Library:

libbps

Description:

The locale_request_events() function starts to deliver locale status change events to your application using BPS. Events will be posted to the currently active channel.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.