Partager via

Méthode ICertificateEnrollmentServerSetup ::InitializeInstallDefaults (casetup.h)

  • Article

La méthode InitializeInstallDefaults initialise l’objet ICertificateEnrollmentServerSetup avec une configuration par défaut.

Syntaxe

HRESULT InitializeInstallDefaults();

Valeur de retour

Code de retour Description
E_ACCESSDENIED
 Un utilisateur doit être administrateur de la racine du domaine ou de l’entreprise. Un ordinateur doit être joint au domaine.

Si l’utilisateur n’est pas un administrateur racine de domaine ou d’entreprise, la propriété ErrorString est définie sur :

« Vous devez être membre du groupe Administrateurs d’entreprise pour exécuter le programme d’installation. »

Si l’ordinateur n’est pas joint au domaine, la propriété ErrorString est définie sur :

« Le service web d’inscription de certificats ou le service web de stratégie d’inscription de certificats ne peuvent pas être installés sur un ordinateur qui n’est pas membre d’un domaine. »
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L’objet ICertificateEnrollmentServerSetup a déjà été initialisé. La propriété ErrorString a la valeur :

« L’objet setup a déjà été initialisé. Cet objet ne peut pas être initialisé plusieurs fois.

Remarques

Cette méthode effectue les actions suivantes :

  • Détermine si l’objet ICertificateEnrollmentServerSetup a déjà été initialisé.
    Note Si cette case activée échoue, la méthode définit la propriété ErrorString sur « L’objet setup a déjà été initialisé. Cet objet ne peut pas être initialisé plusieurs fois.
     
  • Détermine si l’utilisateur est un administrateur de la racine du domaine ou de l’entreprise.
    Note Si cette case activée échoue, la méthode définit la propriété ErrorString sur « Vous devez être membre du groupe Administrateurs d’entreprise pour exécuter le programme d’installation ».
     
  • Détermine si l’ordinateur est joint au domaine.
    Note Si cette case activée échoue, la méthode définit la propriété ErrorString sur « Impossible d’installer le service Web d’inscription de certificats ou le service web de stratégie d’inscription de certificat sur un ordinateur qui n’est pas membre d’un domaine ».
     
  • Définit la procédure d’authentification par défaut sur Kerberos. Vous pouvez appeler SetProperty pour modifier la méthode d’authentification.
  • Détermine si CES est installé sur un ordinateur exécutant Windows Server 2008 R2.
    Note Si cette case activée échoue, la méthode définit la propriété ErrorString sur « Le service web d’inscription de certificat ou le service web de stratégie d’inscription de certificat doit être installé sur un serveur membre dans une forêt Active Directory dans laquelle la version Windows Server 2008 R2 d’ADPrep /forestprep a été correctement exécutée ».
     
  • Définit le contexte du serveur par défaut sur le compte intégré ApplicationPoolIdentity .
  • Définit la propriété ENUM_CESSETUPPROP_RENEWALONLY sur FALSE.
  • Définit la propriété ENUM_CESSETUPPROP_URL sur « https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces » si une configuration d’autorité de certification valide existe. Si aucune configuration valide n’existe, la propriété ENUM_CESSETUPPROP_URL n’est pas définie. SanitizedCAShortName est le nom court aseptisé de l’autorité de certification. Pour plus d’informations sur les noms aseptisés, consultez GetConfig.
    Note Si l’autorité de certification est une autorité de certification autonome, la propriété ErrorString est définie sur « Le service web d’inscription de certificats ne peut pas être utilisé avec une autorité de certification autonome. Il ne peut être utilisé qu’avec une autorité de certification d’entreprise.
     
Vous devez appeler la méthode InitializeInstallDefaults avant d’appeler une méthode autre que UnInstall. Appelez la méthode Install pour installer le service configuré. Appelez UnInstall sur un nouvel objet ICertificateEnrollmentServerSetup pour supprimer le service.

Configuration requise

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

Voir aussi

CESSetupProperty

ICertificateEnrollmentServerSetup