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

Artikel
03/04/2024

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

Die KeySpec-Eigenschaft legt den Typ des generierten Schlüssels fest oder ruft sie ab.

Gültige Werte werden vom verwendeten Kryptografiedienstanbieter (CSP) bestimmt. Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_KeySpec(
  LONG dw
);

Parameter

dw

Rückgabewert

Keine

Bemerkungen

Für den Microsoft Base Cryptographic Provider weist die KeySpec-Eigenschaft den Wert AT_KEYEXCHANGE für Exchange-Schlüssel oder AT_SIGNATURE für Signaturschlüssel auf. Der Standardwert ist AT_SIGNATURE.

Informationen zu den anderen Microsoft-CSPs finden Sie unter Kryptografiedienstanbieter in der CryptoAPI 2.0-Dokumentation.

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

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

Beispiele

DWORD    dwKeySpec;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the KeySpec value
hr = pEnroll->get_KeySpec( &dwKeySpec );
if (FAILED( hr ))
    printf("Failed get_KeySpec - %x\n", hr );
else
    printf( "KeySpec: %d\n", dwKeySpec );

// set the KeySpec value
hr = pEnroll->put_KeySpec( AT_KEYEXCHANGE );
if (FAILED( hr ))
    printf("Failed put_KeySpec - %x\n", hr );
else
    printf( "KeySpec set to %d\n", AT_KEYEXCHANGE );

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