Función SCardReconnect (winscard.h)

  • Artículo

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