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 |
|---|---|
|
Operation erfolgreich abgeschlossen. |
|
Ungültiger Parameter. |
|
Ein fehlerhafter Zeiger wurde in ppCardInfo übergeben. |
|
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 |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCardLocate ist als 1461AACD-6810-11D0-918F-00AA00C18068 definiert. |