ISCardDatabase::ListReaderGroups-Methode
[Die ListReaderGroups-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 ListReaderGroups-Methode ruft die Namen der Lesergruppen ab, die in der Smart Karte-Datenbank registriert sind.
Syntax
HRESULT ListReaderGroups(
[in] LONG localeId,
[out] LPSAFEARRAY *ppReaderGroups
);
Parameter
-
localeId [in]
-
Sprachlokalisierungs-ID.
-
ppReaderGroups [out]
-
Zeiger auf eine SAFEARRAY von BSTRs, die die Namen der intelligenten Karte Lesergruppen enthält, die bei erfolgreicher Ausführung die Suchparameter erfüllt haben; 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 ppReaderGroups übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Um alle bekannten Smartcards oder Leser abzurufen, rufen Sie ListCards bzw . ListReaders 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 Lesergruppen, die in der Smart Karte-Datenbank registriert sind.
LPSAFEARRAY pGroups = NULL;
HRESULT hr;
// Determine the reader groups.
hr = pISCDataBase->ListReaderGroups(0x0409, // English (US)
&pGroups);
if (FAILED(hr))
{
printf("Failed ListReaderGroups\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 |
Siehe auch