ISCard::ReAttach-Methode

Artikel
06/13/2023

[Die ReAttach-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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.]

Mit der ReAttach-Methode wird die intelligente Karte zurückgesetzt oder neu initialisiert.

Syntax

HRESULT ReAttach(
  [in] SCARD_SHARE_MODES  ShareMode,
  [in] SCARD_DISPOSITIONS InitState
);

Parameter

ShareMode [in]

Modus, in dem die Verbindung mit dem intelligenten Karte gemeinsam oder exklusiv besitzt.

Wert	Bedeutung
EXKLUSIVE	Niemand sonst verwendet diese Verbindung mit dem intelligenten Karte.
GETEILT	Andere Anwendungen können diese Verbindung verwenden.

InitState [in]

Gibt an, was mit dem Karte zu tun ist.

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 Reader ü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	Bei einem oder mehreren Parametern, die an die Funktion übergeben werden, liegt ein Fehler vor.

Bemerkungen

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Fehlercode für intelligente Karte zurück, wenn eine intelligente Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Beispiele

Das folgende Beispiel zeigt die erneute Initialisierung des intelligenten Karte.

HRESULT    hr;

// Reattach the smart card.
hr = pISCard->ReAttach(SHARED, LEAVE);
if (FAILED(hr))
{
   printf("Failed ReAttach\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

Siehe auch

AttachByHandle
AttachByReader
Trennen
ISCard

Freigeben über