Partager via

IX509CertificateRequestPkcs10 ::p ut_KeyContainerNamePrefix, méthode (certenroll.h)

  • Article

La propriété KeyContainerNamePrefix spécifie ou récupère un préfixe utilisé pour créer le nom de conteneur d’une nouvelle clé privée.

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

Syntaxe

HRESULT put_KeyContainerNamePrefix(
  BSTR Value
);

Paramètres

Value

Valeur de retour

None

Remarques

Chaque fournisseur de services de chiffrement CryptoAPI ou API de chiffrement : fournisseur de clés CNG (Next Generation) gère un conteneur de clé pour la clé privée. Pour récupérer le nom d’un conteneur de clés pour une clé existante, utilisez la propriété ContainerName de l’objet IX509PrivateKey .

Un préfixe peut contenir n’importe quelle chaîne limitée à la longueur maximale du nom du conteneur de clé et aux caractères de nom de conteneur légaux. Par exemple, si vous n’appelez pas la propriété ContainerName pour spécifier un nom de conteneur de clé, un nom est automatiquement créé lors de la création de la clé privée et le préfixe du nom du conteneur sera la chaîne « lp ». Pour un autre exemple, si vous créez un harnais de test et que vous souhaitez différencier les conteneurs clés par les programmes qui les ont générés, vous pouvez utiliser le nom de l’exécutable comme préfixe.

Vous devez définir cette propriété avant d’appeler la méthode Encode et initialiser l’objet IX509CertificateRequestPkcs10 avant d’appeler cette propriété. Pour plus d’informations, consultez l’une des méthodes suivantes :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certenroll.h
DLL CertEnroll.dll

Voir aussi

IX509CertificateRequestPkcs10