menu_request_get_file_transfer

Retrieve the transfer mode of the menu request object.

Synopsis:

#include "bps/menu.h"

BPS_API int menu_request_get_file_transfer_mode(menu_request_t *request)

Since:

BlackBerry 10.0.0

Arguments:

request: The menu request to retrieve file transfer mode from.

Library:

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

Description:

The menu_request_get_file_transfer_mode() function extracts the file transfer mode (navigator_invoke_file_transfer_mode_t) from the specified menu request object. The allowable return values are:

NAVIGATOR_INVOKE_FILE_TRANSFER_MODE_PRESERVE
NAVIGATOR_INVOKE_FILE_TRANSFER_MODE_COPY_RO
NAVIGATOR_INVOKE_FILE_TRANSFER_MODE_COPY_RW
NAVIGATOR_INVOKE_FILE_TRANSFER_MODE_LINK

Returns:

The menu request file transfer mode if provided by the sender, NAVIGATOR_INVOKE_FILE_TRANSFER_MODE_UNSPECIFIED otherwise. BPS_FAILURE is returned with errno set if an error occurs.