IX509CertificateRequestPkcs10 ::p ut_KeyContainerNamePrefix, méthode (certenroll.h)
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 :
- InitializeDecode
- InitializeFromCertificate
- InitializeFromPrivateKey
- InitializeFromPublicKey
- InitializeFromTemplateName
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 |