SCARD_READERSTATEA構造体 (winscard.h)
SCARD_READERSTATE構造は、リーダー内のスマート カードを追跡するための関数によって使用されます。
構文
typedef struct {
LPCSTR szReader;
LPVOID pvUserData;
DWORD dwCurrentState;
DWORD dwEventState;
DWORD cbAtr;
BYTE rgbAtr[36];
} SCARD_READERSTATEA, *PSCARD_READERSTATEA, *LPSCARD_READERSTATEA;
メンバー
szReader
監視対象のリーダーの名前へのポインター。
このメンバーの値を "\\? に設定します。PnP?\Notification" と他のすべてのメンバーの値をゼロにして、新しいスマート カード リーダーの到着を通知します。
pvUserData
スマート カード サブシステムでは使用されません。 このメンバーは、アプリケーションによって使用されます。
dwCurrentState
アプリケーションによって表示されるリーダーの現在の 状態 。 このフィールドは、次のいずれかの値を組み合わせてビットマスクとして受け取ることができます。
| 値 | 意味 |
|---|---|
|
アプリケーションは現在の 状態を認識せずに、知りたいと思います。 この値を使用すると、状態遷移監視サービスからすぐに戻ります。 これは、0 に設定されたすべてのビットで表されます。 |
|
アプリケーションはこのリーダーに関心を持たず、監視操作中は考慮しないでください。 このビット値が設定されている場合、他のすべてのビットは無視されます。 |
|
アプリケーションは、このリーダーを使用できないことを想定しています。 このビットが設定されている場合、次のビットはすべて無視されます。 |
|
アプリケーションでは、リーダーにカードがないことを想定しています。 このビットが設定されている場合、次のビットはすべて無視されます。 |
|
アプリケーションは、リーダーにカードがあることを想定しています。 |
|
アプリケーションは、ターゲット カードの 1 つに一致する ATR を持つカードがリーダーに存在することを想定しています。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。 このビットは、SCARD_STATE_PRESENT以外の SCardGetStatusChange には意味がありません。 |
|
アプリケーションは、リーダー内のカードが別のアプリケーションによって排他的に使用されるように割り当てられていることを想定しています。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。 |
|
アプリケーションは、リーダー内のカードが 1 つ以上の他のアプリケーションで使用されているが、共有モードで接続されている可能性があることを想定しています。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。 |
|
アプリケーションは、リーダーに応答しないカードがあることを想定しています。 |
|
これは、リーダー内のカードの電源が入っていないことを意味します。 |
dwEventState
スマート カード リソース マネージャーによって認識されるリーダーの現在の状態。 このフィールドは、次のいずれかの値を組み合わせてビットマスクとして受け取ることができます。
| 値 | 意味 |
|---|---|
|
このリーダーは無視する必要があります。 |
|
アプリケーションによって考えられる状態と、リソース マネージャーによって認識される状態には違いがあります。 このビットが設定されている場合、アプリケーションでは、このリーダーで重大な状態変更が発生したと見なされる場合があります。 |
|
指定されたリーダー名は、リソース マネージャーによって認識されません。 このビットが設定されている場合は、SCARD_STATE_CHANGEDとSCARD_STATE_IGNOREも設定されます。 |
|
このリーダーの実際の状態は使用できません。 このビットが設定されている場合、次のすべてのビットがクリアされます。 |
|
リーダーにカードがありません。 このビットが設定されている場合、次のすべてのビットがクリアされます。 |
|
リーダーにカードがあります。 |
|
リーダーには、ターゲット カードの 1 つに一致する ATR を持つカードがあります。 このビットが設定されている場合、SCARD_STATE_PRESENTも設定されます。 このビットは 、SCardLocateCards 関数でのみ返されます。 |
|
リーダー内のカードは、別のアプリケーションで排他的に使用するために割り当てられます。 このビットが設定されている場合、SCARD_STATE_PRESENTも設定されます。 |
|
リーダー内のカードは 1 つ以上の他のアプリケーションで使用されていますが、共有モードで接続されている可能性があります。 このビットが設定されている場合、SCARD_STATE_PRESENTも設定されます。 |
|
リーダーに応答しないカードがあります。 |
|
これは、リーダー内のカードの電源が入っていないことを意味します。 |
cbAtr
返された ATR 内のバイト数。
rgbAtr[36]
追加のアラインメント バイトを持つ挿入されたカードの ATR。
注釈
注意
winscard.h ヘッダーは、SCARD_READERSTATEをエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと混在させると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ヘッダー | winscard.h |