ISCardLocate::FindCard-Methode

Artikel
06/13/2023

[Die FindCard-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 FindCard-Methode sucht nach dem intelligenten Karte und öffnet eine gültige Verbindung mit diesem.

Syntax

HRESULT FindCard(
  [in]  SCARD_SHARE_MODES ShareMode,
  [in]  SCARD_PROTOCOLS   Protocols,
  [in]  LONG              lFlags,
  [out] LPSCARDINFO       *ppCardInfo
);

Parameter

ShareMode [in]

Modus, in dem die intelligente Karte freigegeben werden soll oder nicht, wenn eine Verbindung mit diesem hergestellt wird.

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

Protokolle [in]

Protokoll, das beim Herstellen einer Verbindung mit dem Karte verwendet werden soll.

RAW

T0| T1

lFlags [in]

Gibt an, wann die Benutzeroberfläche angezeigt wird:

Wert	Bedeutung
SC_DLG_MINIMAL_UI	Zeigt das Dialogfeld nur an, wenn die von der aufrufenden Anwendung gesuchte Karte nicht gefunden und für die Verwendung in einem Reader verfügbar ist. Dadurch kann die Karte gefunden, verbunden (entweder über einen internen Dialogfeldmechanismus oder mithilfe der Benutzerrückruffunktionen) und an die aufrufende Anwendung zurückgegeben werden.
SC_DLG_NO_UI	Bewirkt, dass unabhängig vom Suchergebnis keine Anzeige der Benutzeroberfläche angezeigt wird.
SC_DLG_FORCE_UI	Bewirkt die Anzeige der Benutzeroberfläche unabhängig vom Suchergebnis.

ppCardInfo [out]

Zeiger auf einen Zeiger auf eine Datenstruktur, die Informationen zum geöffneten intelligenten Karte enthält oder zurückgibt, falls erfolgreich. Ist NULL , wenn der Vorgang fehlgeschlagen ist.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Rückgabecode	Beschreibung
S_OK	Operation erfolgreich abgeschlossen.
E_INVALIDARG	Ungültiger Parameter.
E_POINTER	In ppCardInfo wurde ein ungültiger Zeiger übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Um die Suchkriterien der Suche festzulegen, rufen Sie ConfigureCardNameSearch auf, um die Karte Namen eines intelligenten Karte anzugeben.

Eine Liste aller Methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardLocate.

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.

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_ISCardLocate ist definiert als 1461AACD-6810-11D0-918F-00AA00C18068

Siehe auch

ConfigureCardNameSearch
ISCardLocate

Freigeben über