estructura OPENCARDNAME_EXA (winscard.h)
La estructura
Sintaxis
typedef struct {
DWORD dwStructSize;
SCARDCONTEXT hSCardContext;
HWND hwndOwner;
DWORD dwFlags;
LPCSTR lpstrTitle;
LPCSTR lpstrSearchDesc;
HICON hIcon;
POPENCARD_SEARCH_CRITERIAA pOpenCardSearchCriteria;
LPOCNCONNPROCA lpfnConnect;
LPVOID pvUserData;
DWORD dwShareMode;
DWORD dwPreferredProtocols;
LPSTR lpstrRdr;
DWORD nMaxRdr;
LPSTR lpstrCard;
DWORD nMaxCard;
DWORD dwActiveProtocol;
SCARDHANDLE hCardHandle;
} OPENCARDNAME_EXA, *POPENCARDNAME_EXA, *LPOPENCARDNAME_EXA;
Miembros
dwStructSize
Longitud, en bytes, de la estructura. El valor de este miembro no debe ser NULL.
hSCardContext
Contexto usado para la comunicación con la tarjeta inteligente resource manager. Llame a
hwndOwner
Ventana propietaria del cuadro de diálogo. Este miembro puede ser cualquier identificador de ventana válido o puede ser NULL para el valor predeterminado del escritorio.
dwFlags
Conjunto de marcas de bits que puede usar para inicializar el cuadro de diálogo. Cuando el cuadro de diálogo vuelve, establece estas marcas para indicar la entrada del usuario. Este miembro puede ser una de las marcas siguientes.
| Valor | Significado |
|---|---|
|
Muestre el cuadro de diálogo solo si la aplicación que realiza la llamada no encuentra la tarjeta que busca y está disponible para su uso en un lector. Esto permite que se encuentre la tarjeta, conectada (ya sea a través del mecanismo del cuadro de diálogo interno o de las funciones de devolución de llamada del usuario) y se devuelva a la aplicación que realiza la llamada. |
|
Forzar ninguna presentación de la Seleccionar tarjetainterfaz de usuario (UI), independientemente del resultado de la búsqueda. |
|
Forzar visualización de la interfaz de usuario de Seleccionar tarjeta, independientemente del resultado de la búsqueda. |
lpstrTitle
Puntero a una cadena que se va a colocar en la barra de título del cuadro de diálogo. Si este miembro es NULL, el sistema usa el título predeterminado "Seleccionar tarjeta:".
lpstrSearchDesc
Puntero a una cadena que se va a mostrar al usuario como una solicitud para insertar la tarjeta inteligente . Si este miembro es NULL, el sistema usa el texto predeterminado "Inserte una tarjeta inteligente".
hIcon
Identificador de un icono (32 x 32 píxeles). Puede especificar un icono específico del proveedor para mostrarlo en el cuadro de diálogo. Si este valor es NULL, se muestra un icono genérico cargado por lector de tarjetas inteligentes.
pOpenCardSearchCriteria
Puntero a la estructura OPENCARD_SEARCH_CRITERIA que se va a usar o NULL, si no se usa uno.
lpfnConnect
Puntero a la rutina de conexión de tarjeta del autor de la llamada. Si el autor de la llamada debe realizar un procesamiento adicional para conectarse a la tarjeta, este puntero de función se establece en la función connect del usuario. Si la función connect se realiza correctamente, la tarjeta se deja conectada e inicializada y se devuelve el identificador de tarjeta.
El prototipo de la rutina de conexión es el siguiente.
Connect(
hSCardContext, // the card context passed in the parameter block
szReader, // the name of the reader
mszCards, // multiple string that contains the possible
// card names in the reader
pvUserData // pointer to user data passed in parameter block
);
pvUserData
Puntero void a los datos del usuario. Este puntero se devuelve al autor de la llamada en la rutina Connect.
dwShareMode
Si
dwPreferredProtocols
Se usa para la conexión interna como se describe en dwShareMode.
lpstrRdr
Si se encuentra la tarjeta, el lpstrRdr búfer contiene el nombre del lector que contiene la tarjeta ubicada. El búfer debe tener al menos 256 caracteres.
nMaxRdr
Tamaño, en bytes (versión ANSI) o caracteres (versión Unicode), del búfer al que apunta lpstrRdr. Si el búfer es demasiado pequeño para contener la información del lector, SCardUIDlgSelectCard devuelve SCARD_E_NO_MEMORY y el tamaño necesario del búfer al que apunta lpstrRdr.
lpstrCard
Si se encuentra la tarjeta, el lpstrCard búfer contiene el nombre de la tarjeta ubicada. El búfer debe tener al menos 256 caracteres.
nMaxCard
Tamaño, en bytes (versión ANSI) o caracteres (versión Unicode), del búfer al que apunta lpstrCard. Si el búfer es demasiado pequeño para contener la información de la tarjeta, SCardUIDlgSelectCard devuelve SCARD_E_NO_MEMORY y el tamaño necesario del búfer en nMaxCard.
dwActiveProtocol
Protocolo real en uso cuando el cuadro de diálogo realiza una conexión a una tarjeta.
hCardHandle
Identificador de la tarjeta conectada (ya sea a través de una conexión de cuadro de diálogo interno o una devolución de llamada lpfnConnect).
Observaciones
Nota
El encabezado winscard.h define OPENCARDNAME_EX 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 |