Compartir a través de


Función SCardReconnect (winscard.h)

La función SCardReconnect restablece una conexión existente entre la aplicación que llama y una tarjeta inteligente. Esta función mueve un identificador de tarjeta desde el acceso directo al acceso general, o reconoce y borra una condición de error que impide el acceso adicional a la tarjeta.

Sintaxis

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

Parámetros

[in] hCard

Valor de referencia obtenido de una llamada anterior a SCardConnect.

[in] dwShareMode

Marca que indica si otras aplicaciones pueden formar conexiones a esta tarjeta.

Valor Significado
SCARD_SHARE_SHARED
Esta aplicación compartirá esta tarjeta con otras aplicaciones.
SCARD_SHARE_EXCLUSIVE
Esta aplicación no compartirá esta tarjeta con otras aplicaciones.

[in] dwPreferredProtocols

Máscara de bits de protocolos aceptables para esta conexión. Los valores posibles se pueden combinar con la operación OR .

El valor de este parámetro debe incluir el protocolo actual. Si intenta volver a conectarse con un protocolo distinto del protocolo actual, se producirá un error.

Valor Significado
SCARD_PROTOCOL_T0
T=0 es un protocolo aceptable.
SCARD_PROTOCOL_T1
T=1 es un protocolo aceptable.

[in] dwInitialization

Tipo de inicialización que se debe realizar en la tarjeta.

Valor Significado
SCARD_LEAVE_CARD
No haga nada especial en la reconexión.
SCARD_RESET_CARD
Restablezca la tarjeta (Restablecimiento intermedio).
SCARD_UNPOWER_CARD
Apague la tarjeta y restablezca (Restablecimiento en frío).

[out, optional] pdwActiveProtocol

Marca que indica el protocolo activo establecido.

Valor Significado
SCARD_PROTOCOL_T0
T=0 es el protocolo activo.
SCARD_PROTOCOL_T1
T=1 es el protocolo activo.

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o se produce un error.

Código devuelto Descripción
Success
SCARD_S_SUCCESS.
Error
Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

SCardReconnect es una función de acceso de lector y tarjeta inteligente. Para obtener información sobre otras funciones de acceso, vea Funciones de acceso de tarjeta inteligente y lector.

Ejemplos

En el ejemplo siguiente se muestra cómo restablecer una conexión.

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winscard.h
Library Winscard.lib
Archivo DLL Winscard.dll

Consulte también

SCardConnect

SCardDisconnect