Función SCardDisconnect (winscard.h)

La función SCardDisconnect finaliza una conexión abierta previamente entre la aplicación que llama y una tarjeta inteligente en el lector de destino.

Sintaxis

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

Parámetros

[in] hCard

Valor de referencia obtenido de una llamada anterior a SCardConnect.

[in] dwDisposition

Acción que se debe realizar en la tarjeta del lector conectado al cerrar.

Value	Significado
SCARD_LEAVE_CARD	No hagas nada especial.
SCARD_RESET_CARD	Restablezca la tarjeta.
SCARD_UNPOWER_CARD	Apaga la tarjeta.
SCARD_EJECT_CARD	Expulse la tarjeta.

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o no.

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

Si una aplicación (denominada anteriormente SCardConnect) sale sin llamar a SCardDisconnect, la tarjeta se restablece automáticamente.

La función SCardDisconnect es una función de acceso de lector y tarjeta inteligente. Para obtener más información sobre otras funciones de acceso, consulte Funciones de acceso de lector y tarjeta inteligente.

Ejemplos

En el ejemplo siguiente se finaliza la conexión de tarjeta inteligente especificada. En el ejemplo se supone que lReturn es una variable de tipo LONG y que hCardHandle es un identificador válido recibido de una llamada anterior a SCardConnect.

lReturn = SCardDisconnect(hCardHandle, 
                          SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardDisconnect\n");
    exit(1);  // Or other appropriate action.
}

Requisitos

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

SCardReconnect