ISCardDatabase::ListReaders-Methode
[Die ListReaders-Methode steht für die Verwendung in den Betriebssystemen zur Verfügung, 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 ListReaders-Methode ruft die Namen der intelligenten Karte-Leser ab, die in der smart Karte-Datenbank registriert sind.
Syntax
HRESULT ListReaders(
[in] LONG localeId,
[out] LPSAFEARRAY *ppReaders
);
Parameter
-
localeId [in]
-
Sprachlokalisierungs-ID.
-
ppReaders [out]
-
Zeiger auf eine SAFEARRAY von BSTRs, die die Namen der intelligenten Karte Leser enthält, falls erfolgreich; NULL, wenn beim Vorgang ein Fehler aufgetreten 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 ppReaders übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Um alle bekannten Smartcards oder Lesergruppen abzurufen, rufen Sie ListCards bzw . ListReaderGroups auf.
Um den primären Dienstanbieter oder die Schnittstellen eines bestimmten Karte GetProviderCardId bzw. ListCardInterfaces abzurufen.
Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardDatabase.
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.
Beispiele
Das folgende Beispiel zeigt das Abrufen der Namen der in der Smart Karte-Datenbank registrierten smart Karte-Leser.
LPSAFEARRAY pReaders = NULL;
HRESULT hr;
// Determine the reader groups.
hr = pISCDataBase->ListReaders(0x0409, // English (US)
&pReaders);
if (FAILED(hr))
{
printf("Failed ListReaders\n");
// Take other error handling action as needed.
}
else
{
// Use the safe array 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 |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCardDatabase ist definiert als 1461AAC8-6810-11D0-918F-00AA00C18068 |
Weitere Informationen