nfc_get_sp_uri()

Return the URI set inside a smart poster URI record.

Synopsis:

#include <nfc/nfc_ndef.h>
 
NFC_API nfc_result_t nfc_get_sp_uri(const nfc_ndef_record_t *sp_rec, char **utf8_uri)

Since:

BlackBerry 10.0.0

Arguments:

sp_rec

The smart poster record containing the embedded URI record in its payload. Chunked NDEF records are not supported.

utf8_uri

The returned allocated null-terminated fully qualified URI in UTF-8. This string must be de-allocated by calling the free() function.

Library:

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

Description:

This function returns, if available, the data associated with the requested URI record embedded inside the smart poster NDEF record payload.

Returns:

NFC_RESULT_SUCCESS, otherwise NFC_RESULT_INVALID_PARAMETER to indicate that a parameter is invalid, or that the provided NDEF record is chunked.