Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|---|---|
|
No hagas nada especial. |
|
Restablezca la tarjeta. |
|
Apaga la tarjeta. |
|
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 |
|---|---|
|
SCARD_S_SUCCESS. |
|
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 |