Méthode ICertAdmin2 ::ImportKey (certadm.h)

Article
08/22/2023

La méthode ImportKey ajoute un jeu de clés chiffrées à un élément de la base de données des services de certificats. Le jeu de clés est chiffré sur un ou plusieurs certificats d’agent de récupération de clé (KRA).

Syntaxe

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Paramètres

[in] strConfig

Valeur de chaîne qui représente une chaîne de configuration valide pour l’autorité de certification sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificats et CANAME est le nom commun de l’autorité de certification, tel qu’entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

Important ImportKey ne efface pas le cache interne lorsque la chaîne de configuration est modifiée. Lorsque vous modifiez la chaîne de configuration de l’autorité de certification, vous devez instancier un nouvel objet ICertAdmin et appeler à nouveau cette méthode avec la nouvelle chaîne de configuration.

[in] RequestId

Valeur LONG qui représente l’ID de demande de certificat dans la base de données Certificates Services. Si le numéro de série (passé en tant que strCertHash) doit être utilisé à la place de l’ID de demande, utilisez zéro pour cette valeur.

[in] strCertHash

Valeur de chaîne qui représente le hachage du certificat. Pour que strCertHash soit utilisé, vous devez spécifier une valeur de zéro pour RequestId.

[in] Flags

Spécifie le format de la clé. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CR_IN_BASE64HEADER	Format BASE64 avec début ou fin.
CR_IN_BASE64	Format BASE64 sans début ni fin.
CR_IN_BINARY	Format binaire.

En outre, la valeur suivante peut être combinée avec la valeur de format à l’aide d’une opération OR au niveau du bit.

Valeur	Signification
IKF_OVERWRITE	Toutes les informations encodées kra existantes sont remplacées.

[in] strKey

Valeur de chaîne qui représente les informations de clé KRA.

Valeur de retour

None

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certadm.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll

Voir aussi

ICertAdmin2

Partager via