nfc_result_t

NFC status code.

Synopsis:

#include <nfc/nfc_types.h>

typedef enum {
      NFC_RESULT_SUCCESS = 0x00   
      NFC_RESULT_INVALID_PARAMETER = 0x01   
      NFC_RESULT_FEATURE_NOT_IMPLEMENTED = 0x02   
      NFC_RESULT_UNSUPPORTED_API = 0x03   
      NFC_RESULT_LOCKED = 0x04   
      NFC_RESULT_LIMITATION_EXCEEDED = 0x05   
      NFC_RESULT_OPERATION_NOT_SUPPORTED = 0x06   
      NFC_RESULT_OPERATION_REJECTED = 0x07   
      NFC_RESULT_SERVICE_CONNECTION_ERROR = 0x08   
      NFC_RESULT_P2P_REJECTED = 0x09   
      NFC_RESULT_TIMEOUT = 0x0A   
      NFC_RESULT_RESOURCE_BUSY = 0x0B   
      NFC_RESULT_NOT_ENOUGH_SPACE = 0x0C   
      NFC_RESULT_OUT_OF_MEMORY = 0x0D   
      NFC_RESULT_FD_ACCESS_ERROR = 0x0E   
      NFC_RESULT_LOCK_FAILED = 0x30   
      NFC_RESULT_WRITE_FAILED = 0x31   
      NFC_RESULT_READ_FAILED = 0x32   
      NFC_RESULT_NOT_NFC_TAG_BUT_CAPABLE = 0x33   
      NFC_RESULT_TAG_NOT_SUPPORTED = 0x34   
      NFC_RESULT_BAD_NDEF_FORMAT = 0x35   
      NFC_RESULT_SE_INPUT_TOO_SHORT = 0x60   
      NFC_RESULT_SE_INVALID_HANDLE = 0x61   
      NFC_RESULT_SE_SERVICE_NOT_READY = 0x62   
      NFC_RESULT_SE_OUT_OF_LOGICAL_CHANNELS = 0x63   
      NFC_RESULT_SE_AID_NOT_FOUND = 0x64   
      NFC_RESULT_SE_INVALID_APDU = 0x65   
      NFC_RESULT_SE_NOT_PRESENT = 0x66   
      NFC_RESULT_SE_REQUEST_REJECTED = 0x67   
      NFC_RESULT_SE_INVALID_SERVICE = 0x68   
      NFC_RESULT_SE_SERVICES_MANAGER_NOT_INITIALIZED = 0x69   
      NFC_RESULT_SE_MISSING_SERVICE_INFORMATION = 0x6A   
      NFC_RESULT_UNHANDLED_ERROR = 0xFE   
      NFC_RESULT_ERROR = 0xFF   
} nfc_result_t;

Since:

BlackBerry 10.0.0

Data:

NFC_RESULT_SUCCESS
The NFC call returned successfully.
NFC_RESULT_INVALID_PARAMETER
An error occurred because an invalid parameter was provided or the parameter is invalid in the feature set used.
NFC_RESULT_FEATURE_NOT_IMPLEMENTED
An error occurred because a non-existent or unimplemented function was called.
NFC_RESULT_UNSUPPORTED_API
An error occurred because an unsupported or deprecated function was called.
NFC_RESULT_LOCKED
An error occurred because an attempt was made to access a locked resource, such as a locked tag/SE.
NFC_RESULT_LIMITATION_EXCEEDED
An error occurred because an attempt to exceed a defined resource limitation was made.

See the specific function description for more information about the error.

NFC_RESULT_OPERATION_NOT_SUPPORTED
An error occurred because a user operation is not supported by the remote connection.
NFC_RESULT_OPERATION_REJECTED
An error occurred because a user operation is not possible in the current state.
NFC_RESULT_SERVICE_CONNECTION_ERROR
An error occurred because the NFC client is unable to communicate with NFC service.
NFC_RESULT_P2P_REJECTED
An error occurred because the remote peer does not support user-requested services.
NFC_RESULT_TIMEOUT
An error occurred because an NFC stack timeout occurred.
NFC_RESULT_RESOURCE_BUSY
An error occurred because the NFC stack is busy and cannot execute the user request.
NFC_RESULT_NOT_ENOUGH_SPACE
An error occurred because there are not enough memory resources.

See the specific function description for more information about the error.

NFC_RESULT_OUT_OF_MEMORY
An error has occurred because the NFC service is not able to allocate enough memory for the operation.

This status code can be returned by any function in the NFC API, even if it is not listed in the documentation of the function.

NFC_RESULT_FD_ACCESS_ERROR
An error when accessing NFC FDs.

Application is likely out of sync with NFC service.

NFC_RESULT_LOCK_FAILED
NFC Tag Errors.

An error occurred because the remote tag is not lockable.

NFC_RESULT_WRITE_FAILED
An error occurred while writing to a tag or during a Logical Link Control Protocol (LLCP) write.

The contents of the tag are likely corrupt or invalid.

NFC_RESULT_READ_FAILED
An error occurred while trying to read a tag or during a LLCP read.
NFC_RESULT_NOT_NFC_TAG_BUT_CAPABLE
An error occurred because the remote tag isn't NFC compliant, however, the remote tag can be formatted.
NFC_RESULT_TAG_NOT_SUPPORTED
An error occurred because the remote tag isn't supported.
NFC_RESULT_BAD_NDEF_FORMAT
An error occurred because the NDEF message could not be built.

The NDEF message could not be built because the provided data isn't in a valid NDEF format.

NFC_RESULT_SE_INPUT_TOO_SHORT
NFC SE Errors.

An NFC Security error occurred because the input buffer was too short.

NFC_RESULT_SE_INVALID_HANDLE
An NFC Security error occurred because the handle provided wasn't valid.
NFC_RESULT_SE_SERVICE_NOT_READY
An NFC Security error occurred; the Secure element service was not initialized.
NFC_RESULT_SE_OUT_OF_LOGICAL_CHANNELS
An NFC Security error occurred because no logical channels were available.

No channels were available because they were all in use.

NFC_RESULT_SE_AID_NOT_FOUND
The applet with the specified Application ID (AID) cannot be found.
NFC_RESULT_SE_INVALID_APDU
The Application Data Unit (APDU) that was provided is malformed or invalid.
NFC_RESULT_SE_NOT_PRESENT
The secure element for a specified reader is not available.
NFC_RESULT_SE_REQUEST_REJECTED
The request was rejected by the Access Control files (ACF), or some other security mechanism.
NFC_RESULT_SE_INVALID_SERVICE
An operation was attempted against a service that does not exist.
NFC_RESULT_SE_SERVICES_MANAGER_NOT_INITIALIZED
An operation was attempted while the SE Services Manager was not initialized.
NFC_RESULT_SE_MISSING_SERVICE_INFORMATION
An operation was attempted against a service for which the platform does not have enough information about to perform.
NFC_RESULT_UNHANDLED_ERROR
Internal errors.

An unhandled internal error occurred.

NFC_RESULT_ERROR
An unexpected error occurred.

Library:

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

Description:

This enumeration defines the Near Field Communication (NFC) status codes supported.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus