ICEnroll ::p ut_GenKeyFlags, méthode (xenroll.h)

Article
03/04/2024

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

La propriété GenKeyFlags définit ou récupère les valeurs passées à la fonction CryptGenKey lorsque la demande de certificat est générée.

Par défaut, la propriété GenKeyFlags a la valeur zéro. Toutefois, lorsqu’un fichier .pvk est spécifié, la valeur de GenKeyFlags est CRYPT_EXPORTABLE par défaut. Pour plus d'informations, consultez la section Notes.

Cette propriété a d’abord été définie dans l’interface ICEnroll .

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

Syntaxe

HRESULT put_GenKeyFlags(
  LONG dwFlags
);

Paramètres

dwFlags

Valeur de retour

None

Remarques

Par défaut, les clés privées ne sont pas exportables, sauf si un fichier .pvk est demandé. Pour rendre la clé privée exportable sans spécifier de fichier .pvk, définissez GenKeyFlags sur CRYPT_EXPORTABLE.

Pour spécifier un nom de fichier .pvk, utilisez la propriété PVKFileName .

La valeur de la propriété GenKeyFlags est passée à la fonction CryptGenKey CryptoAPI à l’aide de son paramètre dwFlags .

Si le fournisseur de services de chiffrement (CSP) ne prend pas en charge les clés privées exportables, une erreur se produit.

La propriété GenKeyFlags affecte le comportement des méthodes suivantes :

Note La valeur par défaut de la propriété GenKeyFlags est zéro. Si vous devez modifier cette valeur, vous devez le faire avant d’appeler ces méthodes. Après avoir appelé l’une de ces méthodes, vous ne pouvez pas modifier la valeur de la propriété GenKeyFlags .

Exemples

LONG     lGenKey;
HRESULT  hr;

// pEnroll is a previously instantiated ICEnroll interface pointer.

// Get the GenKeyFlags value.
hr = pEnroll->get_GenKeyFlags( &lGenKey );
if (FAILED( hr ))
    printf("Failed get_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags: %d\n", lGenKey );

// Set the GenKeyFlags value.
hr = pEnroll->put_GenKeyFlags( CRYPT_EXPORTABLE );
if (FAILED( hr ))
    printf("Failed put_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags set to %d\n", CRYPT_EXPORTABLE );

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