ISCardDatabase::GetProviderCardId-Methode

[Die GetProviderCardId-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 GetProviderCardId-Methode ruft den Bezeichner (GUID) des primären Dienstanbieters für den angegebenen smarten Karte ab.

Syntax

HRESULT GetProviderCardId(
  [in]  BSTR   bstrCardName,
  [out] LPGUID *ppguidProviderId
);

Parameter

bstrCardName [in]

Name des intelligenten Karte.

ppguidProviderId [out]

Zeiger auf den Bezeichner (GUID) des primären Dienstanbieters, falls erfolgreich; NULL , wenn beim Vorgang ein Fehler aufgetreten ist.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Bemerkungen

Um die Schnittstellen des intelligenten Karte aufzulisten, rufen Sie ListCardInterfaces auf.

Um alle bekannten Smartcards abzurufen, rufen Leser und LesergruppenListCards, ListReaders bzw . ListReaderGroups auf.

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 des Bezeichners des primären Dienstanbieters für die angegebene intelligente Karte.

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

Siehe auch

ISCardDatabase

ListCardInterfaces

ListCards

ListReaderGroups

ListReaders