ISCard::D etach-Methode

[Die Detach-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]

Die Detach-Methode schließt die geöffnete Verbindung mit der Smartcard.

Syntax

HRESULT Detach(
  [in] SCARD_DISPOSITIONS Disposition
);

Parameter

Disposition [ In]

Gibt an, was mit der Karte im verbundenen Reader geschehen soll.

Wert Bedeutung
VERLASSEN
Belässt die Smartcard im aktuellen Zustand.
ZURÜCKSETZEN
Setzt die Smartcard auf einen bekannten Zustand zurück.
UNPOWER
Entfernt die Stromversorgung von der Smartcard.
AUSWERFEN
Wirft die Smartcard aus, wenn der Reader über Auswerfenfunktionen verfügt.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Rückgabecode Beschreibung
S _ OK
Operation erfolgreich abgeschlossen.
E _ INVALIDARG
Die Disposition ist ungültig.

Bemerkungen

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Smartcard-Fehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung zu erfüllen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Beispiele

Das folgende Beispiel zeigt, wie die Verbindung mit der Smartcard geschlossen wird.

HRESULT    hr;

// Detach the smart card.
hr = pISCard->Detach(LEAVE);
if (FAILED(hr))
{
   printf("Failed Detach\n");
   // Take error handling action as needed.
}

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Ende des Supports (Client)
Windows XP
Ende des Supports (Server)
Windows Server 2003
Header
Scardmgr.h
Typbibliothek
Scardmgr.tlb
DLL
Scardssp.dll
IID
IID _ ISCard ist als 1461AAC3-6810-11D0-918F-00AA00C18068 definiert.

Weitere Informationen

AttachByHandle

AttachByReader

ISCard

Anfügen