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
S _ OK
Operation erfolgreich abgeschlossen.
E _ INVALIDARG
Ungültiger Parameter.
E _ POINTER
Ein ungültiger Zeiger wurde in ppReaders übergeben.
E _ OUTOFMEMORY
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
Scardmgr.h
Typbibliothek
Scardmgr.tlb
DLL
Scardssp.dll
IID
IID _ ISCardDatabase ist als 1461AAC8-6810-11D0-918F-00AA00C18068 definiert.

Weitere Informationen

GetProviderCardId

ISCardDatabase

ListCardInterfaces

ListCards

ListReaderGroups