ICertificateEnrollmentServerSetup::InitializeInstallDefaults-Methode (casetup.h)

Artikel
08/22/2023

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."

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

Share via