ICEnroll3::get_LimitExchangeKeyToEncipherment-Methode (xenroll.h)

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

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

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

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_LimitExchangeKeyToEncipherment(
  BOOL *fLimitExchangeKeyToEncipherment
);

Parameter

fLimitExchangeKeyToEncipherment

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft ist ein boolescher Wert und wirkt sich nur auf AT_KEYEXCHANGE Anforderungen aus. Es 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

Weitere Informationen

CEnroll

ICEnroll3

ICEnroll4

KeySpec