menu_request_set

Set the action of the menu request.

Synopsis:

#include "bps/menu.h"

BPS_API int menu_request_set_action(menu_request_t *request,
                                    const char *action)

Since:

BlackBerry 10.0.0

Arguments:

request: The menu request.

action: The identifier of the action to be performed by the target. Omitting the action implies brokering applies to any action supported for the specified type or that the target infers the action.

Library:

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

Description:

The menu_request_set_action() function sets the action of the specified menu request. The expected format is up to 50 characters based on the following grammar:

 action: [domain][sub-domain]
 sub-domain: NUL | .[domain][sub-domain]
 domain: [a-zA-Z]([a-zA-Z0-9_])*

For example, "bb.action.SHARE"

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.