Método ICEnroll3::get_LimitExchangeKeyToEncipherment (xenroll.h)

Artículo
03/04/2024

[Esta propiedad ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La propiedad LimitExchangeKeyToEncipherment establece o recupera un valor booleano que determina si una solicitud de AT_KEYEXCHANGE contiene usos de claves de firma digital y de clave que no son de recuperación.

Esta propiedad se introdujo por primera vez en la interfaz ICEnroll3 .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_LimitExchangeKeyToEncipherment(
  BOOL *fLimitExchangeKeyToEncipherment
);

Parámetros

fLimitExchangeKeyToEncipherment

Valor devuelto

None

Observaciones

Esta propiedad es un valor booleano y solo afecta a AT_KEYEXCHANGE solicitudes. No tiene ningún impacto en las solicitudes de AT_SIGNATURE.

Si el valor de esta propiedad es false, una solicitud de AT_KEYEXCHANGE contendrá los siguientes usos de clave:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE

Si el valor de esta propiedad es true, una solicitud de AT_KEYEXCHANGE contendrá los siguientes usos de clave:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE

Ejemplos

// 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

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xenroll.h
Library	Uuid.lib
Archivo DLL	Xenroll.dll

Consulte también