NfcShareError

Since: BlackBerry 10.0.0

#include <bb/system/NfcShareError>

To link against this class, add the following line to your .pro file: LIBS += -lbbsystem

The list of notifications provided to the NfcShareManager::error() signal after an unsuccessful attempt to share content using NFC.


Overview

Public Types

Type

The list of notifications provided to the NfcShareManager::error() signal after an unsuccessful attempt to share content using NFC.

Since:

BlackBerry 10.0.0

Unknown 0

An unknown error occurred.

NoContentToShare 1

No content could be transferred because the sending device failed to set any content to share.

There is no content to transfer because the sending device did not make a successful call to either bb::system::NfcShareManager::setShareContent(const bb::system::NfcShareFilesContent&) or bb::system::NfcShareManager::setShareContent(const bb::system::NfcShareDataContent&).

Since:

BlackBerry 10.0.0

RegisterFileSharing 2

The application was unable to register as a handler for NFC handover events.

For file transfers, the application must register as a handler for NFC handover events. This error occurs when this registration process fails.

Since:

BlackBerry 10.0.0

RegisterDataSharing 3

The application was unable to register as a handler for NFC tag events.

For data transfers, the application must register as a handler for NFC tag events. This error occurs when this registration process fails.

Since:

BlackBerry 10.0.0

MessageSize 4

The recipient NFC tag does not have enough memory for the request.

The user should be advised to use an NFC tag with more memory.

Since:

BlackBerry 10.0.0

TagLocked 5

The user attempted to write content to a locked NFC tag.

Since:

BlackBerry 10.0.0

UnsupportedTagType 6

The user attempted to write content to an NFC tag of an unsupported type.

Since:

BlackBerry 10.0.0

DataTransferFailed 7

An attempt to transfer data to another NFC-enabled device or write data to an NFC tag failed.

"DataTransferFailed" is a recoverable error. This means that if the user attempts to tap the same device again, the transfer will likely succeed. The most frequent reason for this error is that user pulls the device away too soon, and the NFC transaction (file transport negotiation, in the case of file sharing) does not have sufficient time to complete. It may be beneficial to display a system toast to the user inviting them to try the tap again.

Since:

BlackBerry 10.0.0

HandoverFailed 8

The NFC handover negotiation for file transfer failed.

"HandoverFailed" is a non-recoverable error. This means that if user attempts to tap the same device again, the transfer will continue to fail. This error is triggered when two devices had failed to negotiate the transport to use for a file transfer. In other words, it happens because one or more transports specified for sharing (from NfcShareHandoverTransport) are disabled or not supported on one or both devices.

Since:

BlackBerry 10.0.0

BluetoothFileTransferFailed 9

File transfer over Bluetooth failed.

"BluetoothFileTransferFailed" is a non-recoverable error. This means that if user attempts to tap the same device again, the transfer will likely fail again.

Since:

BlackBerry 10.0.0

BluetoothFileTransferCancelled 10

File transfer over Bluetooth was cancelled.

The user can ask to be prompted before sending files using NFC. This notification is sent if the user cancels the transfer in this prompt.

Since:

BlackBerry 10.0.0

TransferInProgress 11

Share mode cannot be changed and no content could be transferred because the transfer to the acquired target is already in progress.

You cannot change the share mode using the NfcShareManager::setShareMode() method once a transfer is in progress. You should not be calling the NfcShareManager::startTransfer() method more than once for each NfcShareSuccess::TargetAcquired signal received when the "Start Transfer" mode is set to NfcShareStartTransferMode::OnDemand.

Since:

BlackBerry 10.2.0

UnsupportedShareMode 12

The user attempted to set a share mode that is currently not supported.

Since:

BlackBerry 10.2.0

WiFiDirectFileTransferFailed 13

File transfer over WiFi Direct failed.

Since:

BlackBerry 10.2.0

WiFiDirectFileTransferCancelled 14

File transfer over WiFi Direct was cancelled.

The user can ask to be prompted before sending files using NFC. This notification is sent if the user cancels the transfer in this prompt.

Since:

BlackBerry 10.2.0

NoTransferTarget 15

The user attempted to start the transfer, when no target was acquired.

Since:

BlackBerry 10.2.0

Last modified: 2014-09-30



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

comments powered by Disqus