Funzione SCardDisconnect (winscard.h)

Articolo
08/27/2023

La funzione SCardDisconnect termina una connessione aperta in precedenza tra l'applicazione chiamante e una smart card nel lettore di destinazione.

Sintassi

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

Parametri

[in] hCard

Valore di riferimento ottenuto da una chiamata precedente a SCardConnect.

[in] dwDisposition

Azione da eseguire sulla scheda nel lettore connesso alla chiusura.

Valore	Significato
SCARD_LEAVE_CARD	Non fare niente di speciale.
SCARD_RESET_CARD	Reimpostare la scheda.
SCARD_UNPOWER_CARD	Spegnere la scheda.
SCARD_EJECT_CARD	Espellere la carta.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito	Descrizione
Success	SCARD_S_SUCCESS.
Operazioni non riuscite	Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card.

Commenti

Se un'applicazione (chiamata in precedenza SCardConnect) viene chiusa senza chiamare SCardDisconnect, la scheda viene reimpostata automaticamente.

La funzione SCardDisconnect è una funzione di accesso tramite smart card e lettore . Per altre informazioni su altre funzioni di accesso, vedere Funzioni di accesso per smart card e lettore.

Esempio

Nell'esempio seguente viene terminata la connessione della smart card specificata. L'esempio presuppone che lReturn sia una variabile di tipo LONG e che hCardHandle sia un handle valido ricevuto da una chiamata precedente a SCardConnect.


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

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winscard.h
Libreria	Winscard.lib
DLL	Winscard.dll

Vedi anche

SCardConnect

SCardReconnect

Condividi tramite