nfc_get_nfc_event()

Retrieve the NFC event associated with the BPS event.

Synopsis:

#include <nfc/nfc_bps.h>
 
NFC_API int nfc_get_nfc_event(bps_event_t *bps_event, nfc_event_t **nfc_event)

Since:

BlackBerry 10.0.0

Arguments:

bps_event

A pointer to the BPS event to get the NFC event from.

nfc_event

A pointer to the NFC event.

Library:

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

Description:

This function retrieves the underlying NFC event that is delivered as part of the BPS event.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE otherwise, with errno set to EINVAL for one of the following errors:
  • NFC domain cannot be obtained.
  • Event passed into the NFC is not valid.
  • Event passed into the NFC is not part of the NFC domain.
  • Payload cannot be obtained from the BPS event.
  • BPS event does not carry a payload.