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