SCARD_READERSTATEW 構造体 (winscard.h)

  • [アーティクル]

SCARD_READERSTATE構造は、リーダー内のスマート カードを追跡するために関数によって使用されます。

構文

typedef struct {
  LPCWSTR szReader;
  LPVOID  pvUserData;
  DWORD   dwCurrentState;
  DWORD   dwEventState;
  DWORD   cbAtr;
  BYTE    rgbAtr[36];
} SCARD_READERSTATEW, *PSCARD_READERSTATEW, *LPSCARD_READERSTATEW;

メンバー

szReader

監視対象のリーダーの名前へのポインター。

このメンバーの値を "\\? に設定します。PnP?\Notification" と他のすべてのメンバーの値をゼロにして、新しいスマート カード リーダーの到着を通知します。

pvUserData

スマート カード サブシステムでは使用されません。 このメンバーは、アプリケーションによって使用されます。

dwCurrentState

アプリケーションに表示されるリーダーの現在の 状態 。 このフィールドは、次のいずれかの値を組み合わせてビットマスクとして受け取ることができます。

値 意味
SCARD_STATE_UNAWARE
 アプリケーションは現在の 状態を認識し、知りたいと考えます。 この値を使用すると、状態遷移監視サービスからすぐに戻ります。 これは、0 に設定されたすべてのビットで表されます。
SCARD_STATE_IGNORE
 アプリケーションはこのリーダーに関心がありません。監視操作中は考慮しないでください。 このビット値が設定されている場合、他のすべてのビットは無視されます。
SCARD_STATE_UNAVAILABLE
 アプリケーションは、このリーダーを使用できないと想定しています。 このビットが設定されている場合、次のすべてのビットは無視されます。
SCARD_STATE_EMPTY
 アプリケーションは、リーダーにカードがないことを想定しています。 このビットが設定されている場合、次のすべてのビットは無視されます。
SCARD_STATE_PRESENT
 アプリケーションは、リーダーにカードがあることを想定しています。
SCARD_STATE_ATRMATCH
 アプリケーションでは、ターゲット カードの 1 つに一致する ATR を持つカードがリーダーに存在することを想定しています。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。 このビットは、SCARD_STATE_PRESENT以外の SCardGetStatusChange には意味がありません。
SCARD_STATE_EXCLUSIVE
 アプリケーションは、リーダー内のカードが別のアプリケーションによって排他的に使用されるように割り当てられていることを想定しています。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。
SCARD_STATE_INUSE
 アプリケーションは、リーダー内のカードが 1 つ以上の他のアプリケーションで使用されていることを想定していますが、共有モードで に接続されている可能性があります。 このビットが設定されている場合は、SCARD_STATE_PRESENTが想定されます。
SCARD_STATE_MUTE
 アプリケーションは、リーダーに応答しないカードがあることを想定しています。
SCARD_STATE_UNPOWERED
 これは、リーダー内のカードが電源が入っていないことを意味します。

dwEventState

スマート カード リソース マネージャーによって認識されるリーダーの現在の状態。 このフィールドは、次のいずれかの値を組み合わせてビットマスクとして受け取ることができます。

値 意味
SCARD_STATE_IGNORE
 このリーダーは無視する必要があります。
SCARD_STATE_CHANGED
 アプリケーションによって認識される状態と、リソース マネージャーによって認識される状態には違いがあります。 このビットが設定されている場合、アプリケーションでは、このリーダーで重大な状態変更が発生したと想定される場合があります。
SCARD_STATE_UNKNOWN
 指定されたリーダー名は、リソース マネージャーによって認識されません。 このビットが設定されている場合は、SCARD_STATE_CHANGEDとSCARD_STATE_IGNOREも設定されます。
SCARD_STATE_UNAVAILABLE
 このリーダーの実際の状態は使用できません。 このビットが設定されている場合は、次のすべてのビットがクリアされます。
SCARD_STATE_EMPTY
 リーダーにカードはありません。 このビットが設定されている場合、次のすべてのビットがクリアされます。
SCARD_STATE_PRESENT
 リーダーにカードがあります。
SCARD_STATE_ATRMATCH
 ターゲット カードの 1 つに一致する ATR を持つカードがリーダーにあります。 このビットが設定されている場合は、SCARD_STATE_PRESENTも設定されます。 このビットは 、SCardLocateCards 関数でのみ返されます。
SCARD_STATE_EXCLUSIVE
 リーダー内のカードは、別のアプリケーションで排他的に使用するために割り当てられます。 このビットが設定されている場合は、SCARD_STATE_PRESENTも設定されます。
SCARD_STATE_INUSE
 リーダー内のカードは、1 つ以上の他のアプリケーションで使用されていますが、共有モードで に接続されている可能性があります。 このビットが設定されている場合は、SCARD_STATE_PRESENTも設定されます。
SCARD_STATE_MUTE
 リーダーに応答しないカードがあります。
SCARD_STATE_UNPOWERED
 これは、リーダー内のカードが電源が入っていないことを意味します。

cbAtr

返された ATR 内のバイト数。

rgbAtr[36]

追加のアラインメント バイトを含む、挿入されたカードの ATR。

注釈

注意

winscard.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてSCARD_READERSTATEを定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header winscard.h

こちらもご覧ください

SCardGetStatusChange

SCardLocateCards