SCardSetCardTypeProviderNameA-Funktion (winscard.h)

Die SCardSetCardTypeProviderName-Funktion gibt den Namen des Moduls (Dynamic Link Library) an, das den Anbieter für einen bestimmten Kartennamen und Anbietertypenthält.

Syntax

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

Parameter

[in] hContext

Behandeln Sie das Ressourcen-Manager-Kontext. Der Ressourcen-Manager-Kontext kann durch einen vorherigen Aufruf von SCardEstablishContextfestgelegt werden. Dieser Wert kann NULL- werden, wenn der Aufruf von SCardCardTypeProviderName nicht an einen bestimmten Kontextweitergeleitet wird.

[in] szCardName

Name des Kartentyps, dem dieser Anbietername zugeordnet ist.

[in] dwProviderId

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

[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.

Bemerkungen

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 SCardCardTypeProviderName zum Abrufen des Anbieternamens verwendet werden kann.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Namen des Kartentypanbieters 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);
}

Anforderungen

Siehe auch

SCardGetCardTypeProviderName