Partager via

IX509PrivateKey ::Create, méthode (certenroll.h)

  • Article

La méthode Create crée une clé privée asymétrique.

Syntaxe

HRESULT Create();

Valeur de retour

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code/valeur de retour Description
HRESULT_FROM_WIN32(ERROR_BUSY)
 Le handle CSP n’est pas NULL.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
 La clé existe déjà.

Remarques

Si vous ne définissez pas les propriétés CspStatus, ProviderName ou ProviderType , cette méthode utilise les valeurs par défaut fournisseur, taille de clé et KeySpec lors de la création de la clé. Sur une nouvelle installation de système d’exploitation, par exemple, le fournisseur de chiffrement microsoft amélioré v1.0 est le fournisseur par défaut.

Si vous ne définissez pas la propriété ContainerName , cette méthode génère automatiquement un nom. Le nom généré inclut un GUID et, si la propriété ContainerNamePrefix n’est pas définie, un préfixe « lp- ». Si le fournisseur est un fournisseur smart carte, le nom généré ne dépassera pas la valeur MaxKeyContainerNameLength spécifiée par le fournisseur. Si le nom généré dépasse initialement cette valeur, il est tronqué à quarante caractères.

Vous ne pouvez pas définir les propriétés suivantes après l’appel des méthodes Create ou Open . Si vous souhaitez les spécifier, vous devez le faire avant d’appeler l’une de ces méthodes.

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

IX509PrivateKey