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

Article
08/22/2023

La méthode SetConfigEntry définit les informations de configuration d’une autorité de certification .

Syntaxe

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

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. Ce paramètre peut être une chaîne vide, auquel cas la fonction définit des informations de configuration qui ne sont pas spécifiques à une autorité de certification. Ce paramètre ne peut pas être NULL.

ImportantSetConfigEntry n’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] strNodePath

Valeur de chaîne qui représente le chemin du nœud pour les informations de configuration. Ce paramètre peut être une chaîne vide, auquel cas la fonction récupère les informations de configuration du chemin identifié par strConfig. Ce paramètre ne peut pas être NULL.

[in] strEntryName

Valeur de chaîne qui représente le nom de l’entrée dont les informations sont définies. Cette valeur peut être une chaîne vide, auquel cas l’entrée par défaut est l’entrée définie. Ce paramètre ne peut pas être NULL.

[in] pvarEntry

C++	Pointeur vers VARIANT qui spécifie les informations à définir. Si cette valeur est vide, la clé indiquée est supprimée.
VB	Variant qui spécifie les informations à définir. Si cette valeur est vide, la clé indiquée est supprimée.

Valeur retournée

VB

Si la fonction réussit, la valeur de retour est S_OK.

Si la fonction échoue, la valeur de retour est un HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Les informations de configuration sont stockées dans le Registre sous le chemin d’accès suivant.

HKEY_LOCAL_MACHINE\SYSTÈME\Currentcontrolset\Services\CertSvc\Configuration\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Où CASANITIZEDNAME est le nom nettoyé de l’autorité de certification. Pour plus d’informations sur les noms nettoyés, consultez ICertConfig2::GetConfig.

Configuration requise


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