ICEnroll3 ::get_LimitExchangeKeyToEncipherment méthode (xenroll.h)

Article
03/13/2024

[Cette propriété n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La propriété LimitExchangeKeyToEncipherment définit ou récupère une valeur booléenne qui détermine si une demande de AT_KEYEXCHANGE contient des utilisations de signature numérique et de clé non répudiation.

Cette propriété a été introduite pour la première fois dans l’interface ICEnroll3 .

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_LimitExchangeKeyToEncipherment(
  BOOL *fLimitExchangeKeyToEncipherment
);

Paramètres

fLimitExchangeKeyToEncipherment

Valeur de retour

None

Remarques

Cette propriété est une valeur booléenne qui affecte uniquement les requêtes AT_KEYEXCHANGE. Elle n’a aucun impact sur les demandes AT_SIGNATURE.

Si la valeur de cette propriété est false, une demande de AT_KEYEXCHANGE contient les utilisations de clé suivantes :

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE

Si la valeur de cette propriété est true, une demande de AT_KEYEXCHANGE contient les utilisations de clé suivantes :

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll