ISCard::ReAttach-Methode

[Die ReAttach-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 ReAttach-Methode setzt die Smartcardzurück oder initialisiert sie erneut.

Syntax

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

Parameter

ShareMode [ In]

Modus, in dem die Verbindung mit der Smartcard freigegeben oder exklusiv besitzt.

Wert Bedeutung
EXKLUSIVE
Diese Verbindung mit der Smartcard wird von niemand anderem verwendet.
GETEILT
Andere Anwendungen können diese Verbindung verwenden.

InitState [ In]

Gibt an, was mit der Karte 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 auswerfende Funktionen 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
Es liegt ein Problem mit einem oder mehreren parametern vor, die an die Funktion übergeben werden.

Bemerkungen

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

Beispiele

Das folgende Beispiel zeigt die erneute Initialisierung der Smartcard.

HRESULT    hr;

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

Trennen

ISCard