ICEnroll::p ut_ProviderFlags-Methode (xenroll.h)

Artikel
03/04/2024

[Diese Eigenschaft ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Mit der ProviderFlags-Eigenschaft wird der Anbietertyp festgelegt oder abgerufen.

Die ProviderFlags-Eigenschaft wird an die CryptoAPI-Funktion CryptAcquireContext übergeben. Gültige Werte werden vom verwendeten Kryptografiedienstanbieter (CSP ) bestimmt.

Der Standardwert für diese Eigenschaft ist Null. Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_ProviderFlags(
  LONG dwFlags
);

Parameter

dwFlags

Rückgabewert

Keine

Bemerkungen

Weitere Informationen zu gültigen ProviderFlags-Werten für den Microsoft-Basis-Kryptografieanbieter finden Sie in der CryptoAPI-Funktion CryptAcquireContext .

Informationen zu anderen CSPs finden Sie in der Dokumentation, die mit dem CSP bereitgestellt wird.

Der Wert der ProviderFlags-Eigenschaft wird mithilfe des dwFlags-Parameters an CryptAcquireContext übergeben.

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

Beispiele

DWORD    dwProvFlags;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer
// get the ProviderFlags value
hr = pEnroll->get_ProviderFlags( &dwProvFlags );
if (FAILED( hr ))
    printf("Failed get_ProviderFlags - %x\n", hr );
else
    printf( "ProviderFlags: %d\n", dwProvFlags );

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

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