structure SCARD_READERSTATEA (winscard.h)
La structure SCARD_READERSTATE est utilisée par les fonctions pour le suivi des cartes à puce dans les lecteurs.
Syntaxe
typedef struct {
LPCSTR szReader;
LPVOID pvUserData;
DWORD dwCurrentState;
DWORD dwEventState;
DWORD cbAtr;
BYTE rgbAtr[36];
} SCARD_READERSTATEA, *PSCARD_READERSTATEA, *LPSCARD_READERSTATEA;
Membres
szReader
Pointeur vers le nom du lecteur surveillé.
Définissez la valeur de ce membre sur « \\? PnP?\Notification » et les valeurs de tous les autres membres à zéro pour être avertis de l’arrivée d’un nouveau lecteur smart carte.
pvUserData
Non utilisé par le sous-système smart carte. Ce membre est utilisé par l’application.
dwCurrentState
État actuel du lecteur, tel que vu par l’application. Ce champ peut prendre l’une des valeurs suivantes, en combinaison, comme masque de bits.
Valeur | Signification |
---|---|
|
L’application ignore l’état actuel et souhaite en savoir plus. L’utilisation de cette valeur entraîne un retour immédiat des services de surveillance de la transition d’état. Cela est représenté par tous les bits définis sur zéro. |
|
L’application n’est pas intéressée par ce lecteur, et elle ne doit pas être prise en compte lors des opérations de surveillance. Si cette valeur de bits est définie, tous les autres bits sont ignorés. |
|
L’application s’attend à ce que ce lecteur ne soit pas disponible pour utilisation. Si ce bit est défini, tous les bits suivants sont ignorés. |
|
L’application s’attend à ce qu’il n’y ait aucune carte dans le lecteur. Si ce bit est défini, tous les bits suivants sont ignorés. |
|
L’application s’attend à ce qu’il y ait une carte dans le lecteur. |
|
L’application s’attend à ce qu’il y ait une carte dans le lecteur avec un ATR qui correspond à l’une des cartes cibles. Si ce bit est défini, SCARD_STATE_PRESENT est supposé. Ce bit n’a aucune signification pour SCardGetStatusChange au-delà de SCARD_STATE_PRESENT. |
|
L’application s’attend à ce que le carte dans le lecteur soit alloué pour une utilisation exclusive par une autre application. Si ce bit est défini, SCARD_STATE_PRESENT est supposé. |
|
L’application s’attend à ce que le carte dans le lecteur soit utilisé par une ou plusieurs autres applications, mais qu’il puisse être connecté en mode partagé. Si ce bit est défini, SCARD_STATE_PRESENT est supposé. |
|
L’application s’attend à ce qu’il y ait un carte qui ne répond pas dans le lecteur. |
|
Cela implique que le carte dans le lecteur n’a pas été alimenté. |
dwEventState
État actuel du lecteur, tel que connu par le gestionnaire de ressourcessmart carte. Ce champ peut prendre l’une des valeurs suivantes, en combinaison, comme masque de bits.
Valeur | Signification |
---|---|
|
Ce lecteur doit être ignoré. |
|
Il existe une différence entre l’état cru par l’application et l’état connu par le gestionnaire de ressources. Lorsque ce bit est défini, l’application peut supposer qu’un changement d’état important s’est produit sur ce lecteur. |
|
Le nom de lecteur donné n’est pas reconnu par le gestionnaire de ressources. Si ce bit est défini, SCARD_STATE_CHANGED et SCARD_STATE_IGNORE seront également définis. |
|
L’état réel de ce lecteur n’est pas disponible. Si ce bit est défini, tous les bits suivants sont clairs. |
|
Il n’y a aucune carte dans le lecteur. Si ce bit est défini, tous les bits suivants sont clairs. |
|
Il y a un carte dans le lecteur. |
|
Il existe un carte dans le lecteur avec un ATR correspondant à l’une des cartes cibles. Si ce bit est défini, SCARD_STATE_PRESENT sera également défini. Ce bit est retourné uniquement sur la fonction SCardLocateCards . |
|
Le carte dans le lecteur est alloué pour une utilisation exclusive par une autre application. Si ce bit est défini, SCARD_STATE_PRESENT sera également défini. |
|
Le carte dans le lecteur est utilisé par une ou plusieurs autres applications, mais peut être connecté en mode partagé. Si ce bit est défini, SCARD_STATE_PRESENT sera également défini. |
|
Il existe un carte qui ne répond pas dans le lecteur. |
|
Cela implique que le carte dans le lecteur n’a pas été alimenté. |
cbAtr
Nombre d’octets dans l’ATR retourné.
rgbAtr[36]
ATR du carte inséré, avec des octets d’alignement supplémentaires.
Remarques
Notes
L’en-tête winscard.h définit SCARD_READERSTATE comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
En-tête | winscard.h |