Método ICEnroll3::p ut_LimitExchangeKeyToEncipherment (xenroll.h)

  • Artigo

[Essa propriedade não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

A propriedade LimitExchangeKeyToEncipherment define ou recupera um valor booliano que determina se uma solicitação de AT_KEYEXCHANGE contém assinatura digital e usos de chave não consultada.

Essa propriedade foi introduzida pela primeira vez na interface ICEnroll3 .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_LimitExchangeKeyToEncipherment(
  BOOL fLimitExchangeKeyToEncipherment
);

Parâmetros

fLimitExchangeKeyToEncipherment

Valor retornado

Nenhum

Comentários

Essa propriedade é um valor booliano e afeta apenas AT_KEYEXCHANGE solicitações. Ele não tem impacto sobre AT_SIGNATURE solicitações.

Se o valor dessa propriedade for false, uma solicitação de AT_KEYEXCHANGE conterá os seguintes usos de chave:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE

Se o valor dessa propriedade for true, uma solicitação de AT_KEYEXCHANGE conterá os seguintes usos de chave:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE

Exemplos

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

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll

Confira também

CEnroll

ICEnroll3

ICEnroll4

KeySpec