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

Article
08/22/2023

La méthode GetConfigEntry récupère les informations de configuration d’une autorité de certification .

Syntaxe

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] 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 récupère des informations de configuration qui ne sont pas spécifiques à une autorité de certification. Ce paramètre ne peut pas être NULL.

Important :GetConfigEntry 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 récupérées. Cette valeur peut être une chaîne vide, auquel cas tous les noms d’entrée sont récupérés. Ce paramètre ne peut pas être NULL.

[out] pvarEntry

Pointeur vers un VARIANT qui reçoit les informations demandées.

Valeur retournée

C++

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.

VB

La valeur de retour est un variant qui représente les informations de configuration récupérées.

Remarques

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

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