ISCardLocate::FindCard-Methode

[Die FindCard-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 FindCard-Methode sucht nach der Smartcard und öffnet eine gültige Verbindung mit ihr.

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 Smartcard beim Öffnen einer Verbindung gemeinsam verwendet oder nicht gemeinsam verwendet werden soll.

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

Protokolle [ In]

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

T0

T1

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 wurde 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 Benutzeroberfläche angezeigt wird.
SC _ DLG _ FORCE _ UI
Bewirkt, dass die Benutzeroberfläche unabhängig vom Suchergebnis angezeigt wird.

ppCardInfo [ out]

Zeiger auf einen Zeiger auf eine Datenstruktur, die Informationen über die geöffnete Smartcardenthält oder zurückgibt, sofern 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-ZEIGER
Ein fehlerhafter Zeiger wurde in ppCardInfo übergeben.
E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

Bemerkungen

Um die Suchkriterien für die Suche festzulegen, rufen Sie ConfigureCardNameSearch auf, um die Kartennamen einer Smartcard anzugeben.

Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardLocate.

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

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

Weitere Informationen

ConfigureCardNameSearch

ISCardLocate