ICEnroll3::p ut_LimitExchangeKeyToEncipherment-Methode (xenroll.h)

Artikel
08/28/2023

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

Die LimitExchangeKeyToEncipherment-Eigenschaft legt einen booleschen Wert fest oder ruft diesen ab, der bestimmt, ob eine AT_KEYEXCHANGE Anforderung digitale Signaturen und Nichtwiedererkennungsschlüsselverwendungen enthält.

Diese Eigenschaft wurde erstmals in der ICEnroll3-Schnittstelle eingeführt.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_LimitExchangeKeyToEncipherment(
  BOOL fLimitExchangeKeyToEncipherment
);

Parameter

fLimitExchangeKeyToEncipherment

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft ist ein boolescher Wert und wirkt sich nur auf AT_KEYEXCHANGE Anforderungen aus. Dies hat keine Auswirkungen auf AT_SIGNATURE Anforderungen.

Wenn der Wert für diese Eigenschaft false ist, enthält eine AT_KEYEXCHANGE-Anforderung die folgenden Schlüsselverwendungen:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE

Wenn der Wert für diese Eigenschaft true ist, enthält eine AT_KEYEXCHANGE-Anforderung die folgenden Schlüsselverwendungen:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE

Beispiele

// Get the LimitExchangeKeyToEncipherment value.
BOOL       bLimitKey;
HRESULT    hr;
// pEnroll is previously instantiated ICEnroll interface pointer.
hr = pEnroll->get_LimitExchangeKeyToEncipherment(&bLimitKey);
if (FAILED(hr))
    printf("Failed get_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf("LimitExchangeKeyToEncipherment: %s\n",
          ( bLimitKey ? "TRUE" : "FALSE"));

// Set the LimitExchangeKeyToEncipherment value.
hr = pEnroll->put_LimitExchangeKeyToEncipherment( TRUE );
if ( FAILED ( hr ) )
    printf("Failed put_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf( "LimitExchangeKeyToEncipherment was set to TRUE\n" );

Anforderungen


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