nfc_se_session_get_atr()

Retrieve the Answer to Reset of this secure element.

Synopsis:

#include <nfc/nfc_se_access.h>

NFC_API nfc_result_t nfc_se_session_get_atr(uint32_t hSESession, uint8_t *pAtr, size_t nLengthOfAtrInBytes, size_t *pLengthOfReturnedAtrInBytes)

Since:

BlackBerry 10.0.0

Arguments:

hSESession: The handle to the session you of interest.

pAtr: ATR of the secure element the session is open for.

nLengthOfAtrInBytes: The length of the ATR buffer sent in.

pLengthOfReturnedAtrInBytes: The length of the ATR returned.

Library:

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

Description:

Returns:

NFC_RESULT_SUCCESS if the session is retrieved successfully; or one of the following:

NFC_RESULT_SERVICE_CONNECTION_ERROR: An attempt to connect to the NFC system has failed.
NFC_RESULT_INVALID_PARAMETER: A parameter is invalid.
NFC_RESULT_SE_INVALID_HANDLE: The hSESession is invalid.
NFC_RESULT_SE_INPUT_TOO_SHORT: The nLengthOfAtrInBytes is shorter than the ATR length. The required buffer length is returned in pLengthOfReturnedAtrInBytes if this error is returned.