Freigeben über


ICertificateEnrollmentServerSetup::InitializeInstallDefaults-Methode (casetup.h)

Die InitializeInstallDefaults-Methode initialisiert das ICertificateEnrollmentServerSetup-Objekt mit einer Standardkonfiguration.

Syntax

HRESULT InitializeInstallDefaults();

Rückgabewert

Rückgabecode BESCHREIBUNG
E_ACCESSDENIED
Ein Benutzer muss ein Administrator des Domänenstamms oder des Unternehmens sein. Ein Computer muss in die Domäne eingebunden sein.

Wenn der Benutzer kein Domänenstamm- oder Unternehmensadministrator ist, wird die ErrorString-Eigenschaft auf Folgendes festgelegt:

"Sie müssen Mitglied der Gruppe Unternehmensadministratoren sein, um Setup ausführen zu können."

Wenn der Computer nicht mit der Domäne verbunden ist, wird die ErrorString-Eigenschaft auf Folgendes festgelegt:

"Der Zertifikatregistrierungswebdienst oder der Zertifikatregistrierungsrichtlinienwebdienst kann nicht auf einem Computer installiert werden, der kein Mitglied einer Domäne ist."

HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
Das ICertificateEnrollmentServerSetup-Objekt wurde bereits initialisiert. Die ErrorString-Eigenschaft ist auf Folgendes festgelegt:

"Das Setupobjekt wurde bereits initialisiert. Dieses Objekt kann nicht mehr als einmal initialisiert werden."

Hinweise

Diese Methode führt die folgenden Aktionen aus:

  • Bestimmt, ob das ICertificateEnrollmentServerSetup-Objekt bereits initialisiert wurde.
    Hinweis Wenn diese Überprüfung fehlschlägt, legt die Methode die ErrorString-Eigenschaft auf "Das Setupobjekt wurde bereits initialisiert. Dieses Objekt kann nicht mehr als einmal initialisiert werden."
     
  • Bestimmt, ob der Benutzer ein Administrator des Domänenstamms oder des Unternehmens ist.
    Hinweis Wenn diese Überprüfung fehlschlägt, legt die Methode die ErrorString-Eigenschaft auf "Sie müssen Mitglied der Gruppe Unternehmensadministratoren sein, um Setup auszuführen".
     
  • Bestimmt, ob der Computer mit der Domäne verbunden ist.
    Hinweis Wenn diese Überprüfung fehlschlägt, legt die Methode die ErrorString-Eigenschaft auf "Der Zertifikatregistrierungswebdienst oder der Zertifikatregistrierungsrichtlinienwebdienst kann nicht auf einem Computer installiert werden, der kein Mitglied einer Domäne ist" fest.
     
  • Legt die Standardauthentifizierungsprozedur auf Kerberos fest. Sie können SetProperty aufrufen, um die Authentifizierungsmethode zu ändern.
  • Bestimmt, ob CES auf einem Computer mit Windows Server 2008 R2 installiert ist.
    Hinweis Wenn diese Überprüfung fehlschlägt, legt die Methode die ErrorString-Eigenschaft auf "Der Zertifikatregistrierungswebdienst oder der Zertifikatregistrierungsrichtlinienwebdienst muss auf einem Mitgliedsserver in einer Active Directory-Gesamtstruktur installiert werden, in dem die Windows Server 2008 R2-Version von ADPrep /forestprep erfolgreich ausgeführt wurde."
     
  • Legt den Standardserverkontext auf das integrierte ApplicationPoolIdentity-Konto fest.
  • Legt die ENUM_CESSETUPPROP_RENEWALONLY-Eigenschaft auf FALSE fest.
  • Legt die ENUM_CESSETUPPROP_URL Eigenschaft auf "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces" fest, wenn eine gültige Zertifizierungsstelle(CA)-Konfiguration vorhanden ist. Wenn keine gültige Konfiguration vorhanden ist, wird die eigenschaft ENUM_CESSETUPPROP_URL nicht festgelegt. SanitizedCAShortName ist der bereinigungslose Kurzname der Zertifizierungsstelle. Weitere Informationen zu bereinigungen Namen finden Sie unter GetConfig.
    Hinweis Wenn die Zertifizierungsstelle eine eigenständige Zertifizierungsstelle ist, wird die ErrorString-Eigenschaft auf "Der Zertifikatregistrierungswebdienst kann nicht mit einer eigenständigen Zertifizierungsstelle (CA) verwendet werden. Sie kann nur mit einer Unternehmenszertifizierungsstelle verwendet werden."
     
Sie müssen die InitializeInstallDefaults-Methode aufrufen, bevor Sie eine andere Methode als UnInstall aufrufen. Rufen Sie die Install-Methode auf, um den konfigurierten Dienst zu installieren. Rufen Sie UnInstall für ein neues ICertificateEnrollmentServerSetup-Objekt auf, um den Dienst zu entfernen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile casetup.h
DLL Certocm.dll

Weitere Informationen

CESSetupProperty

ICertificateEnrollmentServerSetup