ISCardDatabase::ListReaders-Methode
[Die ListReaders-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 ListReaders-Methode ruft die Namen der Smartcardleser ab, die in der Smartcarddatenbankregistriert sind.
Syntax
HRESULT ListReaders(
[in] LONG localeId,
[out] LPSAFEARRAY *ppReaders
);
Parameter
-
localeId [ In]
-
Sprachlokalisierungs-ID.
-
ppReaders [ out]
-
Zeiger auf ein SAFEARRAY von BSTRs, das bei Erfolg die Namen der Smartcardleser enthält; 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 ungültiger Zeiger wurde in ppReaders übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Um alle bekannten Smartcards oder Lesergruppenabzurufen, rufen Sie ListCards bzw. ListReaderGroups auf.
So rufen Sie den primären Dienstanbieter oder die Schnittstellen einer bestimmten Karte ab GetProviderCardId bzw. ListCardInterfaces ab.
Eine Liste aller methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardDatabase.
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Smartcardfehlercode zurück, wenn eine Smartcardfunktion 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 Smartcardleser, die in der Smartcard-Datenbank registriert sind.
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.
// ...
}
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 _ ISCardDatabase ist als 1461AAC8-6810-11D0-918F-00AA00C18068 definiert. |