ISCard::UnlockSCard-Methode

Artikel
06/13/2023

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

Rückgabecode	BESCHREIBUNG
S_OK	Operation erfolgreich abgeschlossen.
E_INVALIDARG	Der Dispositionsparameter ist ungültig.

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

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

ISCard
LockSCard

Freigeben über