ISCard::ReAttach-Methode

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

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

Siehe auch

AttachByHandle

AttachByReader

Trennen

ISCard