nfc_push_ndef_message()

Push an NDEF message to a remote device in a SNEP PUT request.

Synopsis:

#include <nfc/nfc.h>

NFC_API nfc_result_t nfc_push_ndef_message(const nfc_target_t *target, const nfc_ndef_message_t *msg)

Since:

BlackBerry 10.0.0

Arguments:

target: The NDEF target handle found after an NDEF push detection.

msg: The NDEF message to push. If you provide NULL, it will cause the NFC service to abort any active push session if one was in progress.

Library:

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

Description:

This function pushes an NDEF message to a device that supports the NFC Forum SNEP specification. The NDEF message is returned from a successful push detection. Only one NDEF message can be pushed for each NFC tap gesture.

Returns:

NFC_RESULT_SUCCESS, or one of the following:

NFC_RESULT_INVALID_PARAMETER: A parameter is invalid.
NFC_RESULT_SERVICE_CONNECTION_ERROR: The application is not connected to the NFC system.