ISCardLocate::ConfigureCardNameSearch-Methode

Artikel
06/13/2023

[Die ConfigureCardNameSearch-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 ConfigureCardNameSearch-Methode gibt die Karte Namen an, die bei der Suche nach dem intelligenten Karte verwendet werden sollen.

Syntax

HRESULT ConfigureCardNameSearch(
  [in] LPSAFEARRAY pCardNames,
  [in] LPSAFEARRAY pGroupNames,
  [in] BSTR        bstrTitle,
  [in] LONG        lFlags
);

Parameter

pCardNames [in]

Ein Zeiger auf ein sicheres Automation-Array mit Karte Namen in BSTR-Form.

pGroupNames [in]

Ein Zeiger auf ein sicheres Automation-Array von Namen von Karte/Lesergruppen in BSTR-Form, die der Suche hinzugefügt werden sollen.

bstrTitle [in]

Dialogfeldtitel für das allgemeine Steuerelement suchen.

lFlags [in]

Gibt an, wann die Benutzeroberfläche angezeigt wird.

Wert	Bedeutung
SC_DLG_MINIMAL_UI	Zeigt das Dialogfeld nur dann 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	Verursacht unabhängig vom Suchergebnis keine Anzeige der Benutzeroberfläche.
SC_DLG_FORCE_UI	Bewirkt die Anzeige der Benutzeroberfläche unabhängig vom Suchergebnis.

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	Ein fehlerhafter Zeiger wurde in pCardNames oder pGroupNames übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Rufen Sie FindCard auf, um die intelligente Karte zu finden.

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 Intelligenten Karte Fehlercode zurück, wenn eine Smart 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

FindCard
ISCardLocate

Freigeben über