Méthode ICertSrvSetup ::SetCADistinguishedName (casetup.h)

Article
02/23/2024

La méthode SetCADistinguishedName définit un nom commun d’autorité de certification et un suffixe de nom unique facultatif.

Syntaxe

HRESULT SetCADistinguishedName(
  [in] const BSTR   bstrCADN,
  [in] VARIANT_BOOL bIgnoreUnicode,
  [in] VARIANT_BOOL bOverwriteExistingKey,
  [in] VARIANT_BOOL bOverwriteExistingCAInDS
);

Paramètres

[in] bstrCADN

Chaîne qui contient le nom d’une autorité de certification sous la forme CommonName,DistinguishedNameSuffix, où la virgule (,) et DistinguishedNameSuffix sont facultatives.

Le tableau suivant décrit un exemple de nom unique, y compris le suffixe de nom unique facultatif, pour l’ordinateur MyServer.

Valeur	Signification
CN=mydomain-MyServer-CA	Nom commun de l’ordinateur MyServer qui appartient au domaine MyDomain .
DC=MyDomain,DC=MyCompany,DC=com	Suffixe de nom unique (facultatif)
CN=MyDomain-MyServer-CA,DC=MyDomain,DC=MyCompany,DC=com	Nom unique incluant le suffixe facultatif

[in] bIgnoreUnicode

Valeur qui indique s’il faut autoriser l’encodage Unicode des informations de nom. La valeur VARIANT_TRUE active l’encodage Unicode.

[in] bOverwriteExistingKey

Valeur qui indique s’il faut autoriser le nom dans bstrCADN, même si une clé privée portant le même nom existe sur l’ordinateur. La valeur VARIANT_TRUE permet à la méthode de remplacer la clé existante.

[in] bOverwriteExistingCAInDS

Valeur qui indique s’il faut autoriser le nom dans bstrCADN, même si une autorité de certification portant le même nom unique existe dans le service d’annuaire. La valeur VARIANT_TRUE permet à la méthode de remplacer l’entrée de service d’annuaire existante.

Valeur de retour

None

Remarques

En cas de réussite, la méthode SetCADistinguishedName modifie la ENUM_SETUPPROP_CANAME et ENUM_SETUPPROP_CADSSUFFIX valeurs de propriété pour refléter le nom bstrCADN . Pour plus d’informations sur les propriétés d’installation, consultez CASetupProperty.

En cas d’échec, la méthode SetCADistinguishedName peut définir des informations d’erreur supplémentaires dans les propriétés CAErrorId et CAErrorString .

Si une clé existante et son certificat associé sont utilisés pour configurer l’autorité de certification, cette méthode ne doit pas être appelée. Si une clé existante est utilisée pour configurer l’autorité de certification, sans utiliser le certificat associé, le nom commun dans bstrCADN doit correspondre au ContainerNameassaini de la clé.

Si bstrCADN inclut l’encodage UTF8, définissez l’indicateur approprié dans CAPolicy.inf et placez-le dans le %windir%.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	casetup.h
DLL	Certocm.dll

Voir aussi

ICertSrvSetup

Partager via