SCardDisconnect-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardDisconnect-Funktion beendet eine Verbindung, die zuvor zwischen der aufrufenden Anwendung und einem intelligenten Karte im Zielleser geöffnet wurde.

Syntax

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

Parameter

[in] hCard

Verweiswert, der von einem vorherigen Aufruf von SCardConnect abgerufen wurde.

[in] dwDisposition

Aktion zum Ausführen des Karte im verbundenen Leser beim Schließen.

Wert	Bedeutung
SCARD_LEAVE_CARD	Machen Sie nichts Besonderes.
SCARD_RESET_CARD	Setzen Sie die Karte zurück.
SCARD_UNPOWER_CARD	Schalten Sie die Karte herunter.
SCARD_EJECT_CARD	Werfen Sie den Karte aus.

Rückgabewert

Diese Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.

Rückgabecode	BESCHREIBUNG
Erfolgreich	SCARD_S_SUCCESS.
Fehler	Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Wenn eine Anwendung (die zuvor SCardConnect genannt wurde) beendet wird, ohne SCardDisconnect aufzurufen, wird die Karte automatisch zurückgesetzt.

Die SCardDisconnect-Funktion ist eine intelligente Karte- und Lesezugriffsfunktion. Weitere Informationen zu anderen Zugriffsfunktionen finden Sie unter Smartcard- und Lesezugriffsfunktionen.

Beispiele

Im folgenden Beispiel wird die angegebene Smart Karte-Verbindung beendet. Im Beispiel wird davon ausgegangen, dass lReturn eine Variable vom Typ LONG ist und dass hCardHandle ein gültiges Handle ist, das von einem vorherigen Aufruf von SCardConnect empfangen wurde.


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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
Bibliothek	Winscard.lib
DLL	Winscard.dll

Weitere Informationen

SCardConnect

SCardReconnect

Freigeben über