Funzione SCardDisconnect (winscard.h)

  • Articolo

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