ISCardManage::AttachByHandle メソッド
[ AttachByHandle メソッドは、[要件] セクションで指定されたオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
AttachByHandle メソッドは、スマート カードリソース マネージャーによって返されるハンドルを使用して、スマート カード (ICC) への通信リンクを作成します。
構文
HRESULT AttachByHandle(
[in] HSCARD hICC
);
パラメーター
-
hICC [in]
-
スマート カードへのハンドル。
戻り値
メソッドは、次のいずれかの可能な値を返します。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
hICC パラメーターが無効です。 |
|
メモリが不足しています。 |
解説
リーダーをアタッチするには、AttachByIFD を呼び出します。
添付ファイルを解放するには、デタッチを呼び出 します。
Detach と AttachByHandle を呼び出さずにスマート カードに再接続するには、Reconnect を呼び出します。
ISCardManage インターフェイスで定義されているすべてのメソッドの一覧については、「ISCardManage」を参照してください。
上記の COM エラー コードに加えて、スマート カード関数が呼び出されて要求を完了した場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 スマート カードエラー コードの詳細については、「スマート カードの戻り値」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
関連項目