ISCardDatabase::GetProviderCardId-Methode
[Die GetProviderCardId-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 GetProviderCardId-Methode ruft den Bezeichner (GUID) des primären Dienstanbieters für die angegebene Smartcardab.
Syntax
HRESULT GetProviderCardId(
[in] BSTR bstrCardName,
[out] LPGUID *ppguidProviderId
);
Parameter
-
bstrCardName [ In]
-
Name der Smartcard.
-
ppguidProviderId [ out]
-
Zeiger auf den Bezeichner des primären Dienstanbieters (GUID), falls erfolgreich; 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 ppguidProviderId übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Um die Schnittstellen der Smartcard aufzulisten, rufen Sie ListCardInterfaces auf.
Um alle bekannten Smartcardsabzurufen, rufen Leser und Lesergruppen ListCards, ListReadersbzw. ListReaderGroups auf.
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 des Bezeichners des primären Dienstanbieters für die angegebene Smartcard.
BSTR bstrCard = NULL;
LPGUID pguidProvId = NULL;
HRESULT hr;
bstrCard = SysAllocString(L"My Card");
hr = pISCDataBase->GetProviderCardId(bstrCard,&pguidProvId);
if (FAILED(hr))
{
printf("Failed GetProviderCardId\n");
}
else
{
// Use pguidProvId as needed.
}
// Free BSTR when done.
if ( NULL != bstrCard )
{
SysFreeString(bstrCard);
bstrCard=NULL;
}
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. |