Freigeben über


SCardDisconnect-Funktion (winscard.h)

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