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

Weitere Informationen

ISCardDatabase

ListCardInterfaces

ListCards

ListReaderGroups

ListReaders