Partager via


ICEnroll3::p ut_LimitExchangeKeyToEncipherment, méthode (xenroll.h)

[Cette propriété n’est plus disponible à partir de 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 requête 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 put_LimitExchangeKeyToEncipherment(
  BOOL fLimitExchangeKeyToEncipherment
);

Paramètres

fLimitExchangeKeyToEncipherment

Valeur de retour

None

Remarques

Cette propriété est une valeur booléenne qui affecte uniquement AT_KEYEXCHANGE requêtes. 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" );

Spécifications

   
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

Voir aussi

CEnroll

ICEnroll3

ICEnroll4

KeySpec