ICEnroll::get_ProviderType-Methode (xenroll.h)

Artikel
03/13/2024

[Diese Eigenschaft steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die ProviderType-Eigenschaft legt den Anbietertyp fest oder ruft sie ab.

Der Wert der ProviderType-Eigenschaft wird an die CryptoAPI-Funktion CryptAcquireContext übergeben. Gültige Werte werden vom verwendeten Kryptografiedienstanbieter (CSP) bestimmt. Der Standardwert für diese Eigenschaft ist 1. Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_ProviderType(
  LONG *pdwType
);

Parameter

pdwType

Rückgabewert

Keine

Bemerkungen

Allgemeine Informationen zu Anbietertypen finden Sie unter Kryptografieanbietertypen.

Weitere Informationen zu gültigen Werten für den Microsoft Base Cryptographic Provider finden Sie in der CryptoAPI-Funktion CryptAcquireContext .

Informationen zum Anbietertyp für andere CSPs finden Sie in der Dokumentation, die mit dem CSP bereitgestellt wird.

Der ProviderType-Eigenschaftswert wird mithilfe des dwProvType-Parameters an CryptAcquireContext übergeben.

Die ProviderType-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:

Beispiele

DWORD    dwProvType;
HRESULT  hr;

// Get the ProviderType value.
// pEnroll is previously instantiated ICEnroll interface pointer
hr = pEnroll->get_ProviderType(&dwProvType);
if (FAILED( hr ))
    printf("Failed get_ProviderType - %x\n", hr);
else
    printf("ProviderType: %d\n", dwProvType);

// Set the ProviderType value.
hr = pEnroll->put_ProviderType(PROV_MS_EXCHANGE);
if (FAILED(hr))
    printf("Failed put_ProviderType - %x\n", hr);
else
    printf("ProviderType set to %d\n", PROV_MS_EXCHANGE);

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	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über