User manual - NFCFelicaライブラリマニュアルver.1.01(2012年3月29日)

32
3.20 NFCFelicaSamAuthentication
NFCFelica ライブラリと SAM カードとの相互認証を実行します。
[C++]
int NFCFelicaSamAuthentication(
DWORD dwSlotNumber ,
DWORD dwReserved
)
[Visual Basic]
Public Shared Function NFCFelicaSamAuthentication( _
ByVal dwSlotNumber As Int32, _
ByVal dwReserved As Int32 _
) As Int32
[C#]
public static Int32 NFCFelicaSamAuthentication(
Int32 dwSlotNumber ,
Int32 dwReserved
)
解説
本関数は、NFCFelica ライブラリと SAM カード（RC-S251）との相互認証を実行します。
相互認証に成功すると、NFCFelicaAuthentication関数、NFCFelicaReadWithEncryption関数、およ
びNFCFelicaWriteWithEncryption関数が使用可能になります。
また、本関数実行後に再度本関数を実行すると、SAM カードとの通信回数をリセットします。
パラメータ
dwSlotNumber
通信対象の SAM カードを挿入したカードスロット番号を指定します。（1∼カードスロット数）
dwReserved
現在のバージョンではこの引数を使用しません。0 を指定してください。
戻り値
以下の値を返します。
NFC_OK
: 正常終了
NFC_NOT_DEVICE
: NFC ドライバエラー
DeviceEmulator では発生しません
NFC_POF
: 未オープンエラー
NFC_PRM
: パラメータエラー
NFC_ERROR_NOCARD
: SAM カード未挿入エラー
NFC_ERROR_ACTIVATION
: SAM カード未起動エラー
NFC_ERROR_TIMEOUT
: タイムアウトエラー
NFC_ERROR_SUSPEND
: 本体電源 OFF エラー
NFC_ERROR_RESPONSE
: カード異常応答発生エラー