nfc_get_handover_role()

#include <nfc/nfc.h>
 

NFC_API nfc_result_t nfc_get_handover_role(nfc_target_t *target, handover_role_t *role)

Since:

BlackBerry 10.0.0

Arguments:

target

The NFC target returned from the nfc_get_target() function.

role

The returned role of connection handover negotiation.

Library:

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

Description:

This function gets the role of the device involved in the connection handover negotiation. The retrieval of the role of the device is dependent on the successful completion of the connection handover. Therefore, the application must wait for the NFC_HANDOVER_COMPLETE_EVENT before using this function.

Returns:

NFC_RESULT_SUCCESS, or NFC_RESULT_INVALID_PARAMETER, which indicates that an invalid argument was passed to the function.