ISCard::D etach-Methode

Artikel
06/13/2023

[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 dem smarten Karte.

Syntax

HRESULT Detach(
  [in] SCARD_DISPOSITIONS Disposition
);

Parameter

Disposition [in]

Gibt an, was mit dem Karte im verbundenen Reader ausgeführt werden soll.

Wert	Bedeutung
VERLASSEN	Belässt die intelligente Karte im aktuellen Zustand.
RESET	Setzt die intelligente Karte auf einen bekannten Zustand zurück.
UNPOWER	Entfernt die Energie aus dem intelligenten Karte.
AUSWERFEN	Löst die intelligente Karte aus, wenn der Leser über Auswurffunktionen 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 Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Beispiele

Das folgende Beispiel zeigt das Schließen der Verbindung mit dem intelligenten Karte.

HRESULT    hr;

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur 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 definiert als 1461AAC3-6810-11D0-918F-00AA00C18068

Weitere Informationen

AttachByHandle
AttachByReader
ISCard
Anfügen

Freigeben über