Freigeben über


SCardCancel-Funktion (winscard.h)

Die SCardCancel-Funktion beendet alle ausstehenden Aktionen innerhalb eines bestimmten Ressourcen-Manager-Kontexts.

Die einzigen Anforderungen, die Sie abbrechen können, sind solche, die auf externe Aktionen durch den intelligenten Karte oder Benutzer warten müssen. Alle ausstehenden Aktionsanforderungen werden mit einem status Hinweis darauf beendet, dass die Aktion abgebrochen wurde. Dies ist besonders nützlich, um das Beenden ausstehender SCardGetStatusChange-Aufrufe zu erzwingen.

Syntax

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContext festgelegt.

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

Die SCardCancel-Funktion ist eine intelligente Karte Tracking-Funktion. Eine Beschreibung anderer Nachverfolgungsfunktionen finden Sie unter Smartcard-Nachverfolgungsfunktionen.

Beispiele

Im folgenden Beispiel werden alle ausstehenden Aktionen im angegebenen Kontext abgebrochen. Im Beispiel wird davon ausgegangen, dass lReturn eine vorhandene Variable vom Typ LONG ist und dass hContext ein gültiges Handle ist, das von einem vorherigen Aufruf von SCardEstablishContext empfangen wurde.


lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

Anforderungen

Anforderung Wert
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

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards