SCardSetCardTypeProviderNameA-Funktion (winscard.h)

  • Artikel

Die SCardSetCardTypeProviderName-Funktion gibt den Namen des Moduls (Dynamic Link Library) an, das den Anbieter für einen angegebenen Karte Namen und Anbietertyp enthält.

Syntax

LONG SCardSetCardTypeProviderNameA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName,
  [in] DWORD        dwProviderId,
  [in] LPCSTR       szProvider
);

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext kann durch einen vorherigen Aufruf von SCardEstablishContext festgelegt werden. Dieser Wert kann NULL sein, wenn der Aufruf von SCardSetCardTypeProviderName nicht an einen bestimmten Kontext weitergeleitet wird.

[in] szCardName

Name des Karte Typs, dem dieser Anbietername zugeordnet ist.

[in] dwProviderId

Bezeichner für den Anbieter, der diesem Karte Typ zugeordnet ist.

Wert Bedeutung
SCARD_PROVIDER_PRIMARY
1
 Die Funktion ruft den Namen des primären Dienstanbieters des intelligenten Karte als GUID-Zeichenfolge ab.
SCARD_PROVIDER_CSP
2
 Die Funktion ruft den Namen des Kryptografiedienstanbieters (Cryptographic Service Provider , CSP) ab.
SCARD_PROVIDER_KSP
3
 Die Funktion ruft den Namen des Smart Karte Schlüsselspeicheranbieters (KSP) ab.
SCARD_PROVIDER_CARD_MODULE
0x80000001
 Die Funktion ruft den Namen des Karte Moduls ab.

[in] szProvider

Eine Zeichenfolge, die den Anbieternamen enthält, der den CSP darstellt.

Rückgabewert

Diese Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.

Rückgabecode BESCHREIBUNG
Erfolgreich
 SCARD_S_SUCCESS.
Fehler
 Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Diese Funktion wird nicht umgeleitet, aber das Aufrufen der Funktion in einer Remotedesktopsitzung führt nicht zu einem Fehler. Dies bedeutet nur, dass das Ergebnis vom Remotecomputer statt vom lokalen Computer stammt.

Diese Funktion legt den Anbieternamen fest, während SCardGetCardTypeProviderName zum Abrufen des Anbieternamens verwendet werden kann.

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie den namen des Karte Typanbieters angeben.

LPTSTR            szNewProvName = _T("My Provider Name");
LPTSTR            szCardName = _T("WindowsCard");
LONG              lReturn = SCARD_S_SUCCESS;

// Set the card type provider name.
// hContext was set by SCardEstablishContext.
lReturn = SCardSetCardTypeProviderName(hContext,
                                      szCardName,
                                      SCARD_PROVIDER_CSP,
                                      szNewProvName);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardSetCardTypeProviderName - %x\n", lReturn);
    exit(1);
}

Hinweis

Der winscard.h-Header definiert SCardSetCardTypeProviderName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winscard.h
Bibliothek Winscard.lib
DLL Winscard.dll

Weitere Informationen

SCardGetCardTypeProviderName