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 |
|---|---|
|
SCARD_S_SUCCESS. |
|
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 |