ISCard::UnlockSCard-Methode

[Die UnlockScard-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.]

Die UnlockScard-Methode gibt exklusiven Zugriff auf die intelligente Karte frei.

Syntax

HRESULT UnlockSCard(
  [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 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 Freigabe des exklusiven Zugriffs auf die intelligente Karte.

HRESULT    hr;

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

Anforderungen

Siehe auch

ISCard

LockSCard