ISCardAuth::GetChallenge メソッド
[ GetChallenge メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
GetChallenge メソッドは、スマート カードからチャレンジを返します。
構文
HRESULT GetChallenge(
[in, optional] LONG lAlgoID,
[in] LONG lLengthOfChallenge,
[in] LPBYTEBUFFER pParam,
[in, out] LPBYTEBUFFER *pBuffer
);
パラメーター
-
lAlgoID [in, optional]
-
認証プロセスで使用されるアルゴリズム。
-
lLengthOfChallenge [in]
-
予想される応答の最大長。
-
pParam [in]
-
認証プロセスのベンダー固有のパラメーターを含む IByteBuffer オブジェクト。
-
pBuffer [in, out]
-
入力時に、 はバッファーを指します。
出力時には、カードからのチャレンジ データが含まれます。
戻り値
メソッドは、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
操作は正常に完了しました。 |
|
無効なパラメーター。 |
|
不適切なポインターが渡されました。 |
|
メモリが不足しています。 |
解説
このインターフェイスによって提供されるすべてのメソッドの一覧については、「 ISCardAuth」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
クライアント サポートの終了 |
Windows XP |
サーバー サポートの終了 |
Windows Server 2003 |
関連項目