estructura SCARD_READERSTATEA (winscard.h)

Artículo
11/20/2024

Las funciones usan la estructura SCARD_READERSTATE para realizar el seguimiento de tarjetas inteligentes dentro de lectores.

Sintaxis

typedef struct {
  LPCSTR szReader;
  LPVOID pvUserData;
  DWORD  dwCurrentState;
  DWORD  dwEventState;
  DWORD  cbAtr;
  BYTE   rgbAtr[36];
} SCARD_READERSTATEA, *PSCARD_READERSTATEA, *LPSCARD_READERSTATEA;

Miembros

szReader

Puntero al nombre del lector que se está supervisando.

Establezca el valor de este miembro en "\\? PnP?\Notification" y los valores de todos los demás miembros a cero para recibir una notificación de la llegada de un nuevo lector de tarjetas inteligentes.

pvUserData

No se usa en el subsistema de tarjeta inteligente de . La aplicación usa este miembro.

dwCurrentState

Estado actual del lector, tal como lo ve la aplicación. Este campo puede tomar cualquiera de los siguientes valores, en combinación, como máscara de bits.

Valor	Significado
SCARD_STATE_UNAWARE	La aplicación no es consciente del estado actual y le gustaría saberlo. El uso de este valor da como resultado una devolución inmediata de los servicios de supervisión de transición de estado. Esto se representa mediante todos los bits establecidos en cero.
SCARD_STATE_IGNORE	La aplicación no está interesada en este lector y no debe tenerse en cuenta durante las operaciones de supervisión. Si se establece este valor de bit, se omiten todos los demás bits.
SCARD_STATE_UNAVAILABLE	La aplicación espera que este lector no esté disponible para su uso. Si se establece este bit, se omiten todos los bits siguientes.
SCARD_STATE_EMPTY	La aplicación espera que no haya ninguna tarjeta en el lector. Si se establece este bit, se omiten todos los bits siguientes.
SCARD_STATE_PRESENT	La aplicación espera que haya una tarjeta en el lector.
SCARD_STATE_ATRMATCH	La aplicación espera que haya una tarjeta en el lector con un ATR que coincida con una de las tarjetas de destino. Si se establece este bit, se supone SCARD_STATE_PRESENT. Este bit no tiene sentido SCardGetStatusChange más allá de SCARD_STATE_PRESENT.
SCARD_STATE_EXCLUSIVE	La aplicación espera que otra aplicación asigne la tarjeta en el lector para uso exclusivo. Si se establece este bit, se supone SCARD_STATE_PRESENT.
SCARD_STATE_INUSE	La aplicación espera que la tarjeta del lector esté en uso por una o varias aplicaciones, pero puede estar conectada en modo compartido. Si se establece este bit, se supone SCARD_STATE_PRESENT.
SCARD_STATE_MUTE	La aplicación espera que haya una tarjeta que no responde en el lector.
SCARD_STATE_UNPOWERED	Esto implica que la tarjeta del lector no se ha encendido.

dwEventState

Estado de actual dellector de , tal y como se conoce en la tarjeta inteligente resource Manager. Este campo puede tomar cualquiera de los siguientes valores, en combinación, como máscara de bits.

Valor	Significado
SCARD_STATE_IGNORE	Este lector debe omitirse.
SCARD_STATE_CHANGED	Hay una diferencia entre el estado que cree la aplicación y el estado conocido por el administrador de recursos. Cuando se establece este bit, la aplicación puede suponer que se ha producido un cambio de estado significativo en este lector.
SCARD_STATE_UNKNOWN	El administrador de recursos no reconoce el nombre del lector especificado. Si se establece este bit, también se establecerá SCARD_STATE_CHANGED y SCARD_STATE_IGNORE.
SCARD_STATE_UNAVAILABLE	El estado real de este lector no está disponible. Si se establece este bit, se borran todos los bits siguientes.
SCARD_STATE_EMPTY	No hay ninguna tarjeta en el lector. Si se establece este bit, se borrarán todos los bits siguientes.
SCARD_STATE_PRESENT	Hay una tarjeta en el lector.
SCARD_STATE_ATRMATCH	Hay una tarjeta en el lector con una ATR que coincida con una de las tarjetas de destino. Si se establece este bit, también se establecerá SCARD_STATE_PRESENT. Este bit solo se devuelve en la función SCardLocateCards.
SCARD_STATE_EXCLUSIVE	Otra aplicación asigna la tarjeta del lector para su uso exclusivo. Si se establece este bit, también se establecerá SCARD_STATE_PRESENT.
SCARD_STATE_INUSE	La tarjeta del lector está en uso por una o varias aplicaciones, pero se puede conectar a en modo compartido. Si se establece este bit, también se establecerá SCARD_STATE_PRESENT.
SCARD_STATE_MUTE	Hay una tarjeta que no responde en el lector.
SCARD_STATE_UNPOWERED	Esto implica que la tarjeta del lector no se ha encendido.

cbAtr

Número de bytes en el ATR devuelto.

rgbAtr[36]

ATR de la tarjeta insertada, con bytes de alineación adicionales.

Observaciones

Nota

El encabezado winscard.h define SCARD_READERSTATE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	winscard.h

Consulte también

SCardGetStatusChange

SCardLocateCards

Compartir a través de