Condividi tramite


Metodo ICEnroll3::p ut_LimitExchangeKeyToEncipherment (xenroll.h)

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà LimitExchangeKeyToEncipherment imposta o recupera un valore booleano che determina se una richiesta di AT_KEYEXCHANGE contiene firme digitali e utilizzo delle chiavi non di sospensione.

Questa proprietà è stata introdotta per la prima volta nell'interfaccia ICEnroll3 .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_LimitExchangeKeyToEncipherment(
  BOOL fLimitExchangeKeyToEncipherment
);

Parametri

fLimitExchangeKeyToEncipherment

Valore restituito

nessuno

Osservazioni

Questa proprietà è un valore booleano e influisce solo sulle richieste AT_KEYEXCHANGE. Non ha alcun impatto sulle richieste di AT_SIGNATURE.

Se il valore per questa proprietà è false, una richiesta di AT_KEYEXCHANGE conterrà gli utilizzi chiave seguenti:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE

Se il valore per questa proprietà è true, una richiesta di AT_KEYEXCHANGE conterrà gli utilizzi chiave seguenti:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE

Esempio

// 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" );

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll

Vedi anche

CEnroll

ICEnroll3

ICEnroll4

KeySpec