ICertificateEnrollmentServerSetup::UnInstall-Methode (casetup.h)

Artikel
02/26/2024

Die UnInstall-Methode entfernt den Zertifikatregistrierungswebdienst (Certificate Enrollment Web Service, CES).

Syntax

HRESULT UnInstall(
  VARIANT *pCAConfig,
  VARIANT *pAuthentication
);

Parameter

pCAConfig

Dieser Parameter ist für die zukünftige Verwendung reserviert.

pAuthentication

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Rückgabecode	BESCHREIBUNG
E_ACCESSDENIED	Der Benutzer muss ein lokaler Administrator sein. Der Wert der ErrorString-Eigenschaft ist auf "Sie müssen der administrator des lokalen Computers sein, um dieses Setup ausführen zu können" festgelegt.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Das ICertificateEnrollmentServerSetup-Objekt wurde initialisiert. Ein -Objekt wird initialisiert, wenn Sie InitializeInstallDefaults erfolgreich aufrufen. Der Wert der ErrorString-Eigenschaft ist auf "Das Objekt wurde initialisiert. Sie können UnInstall für ein initialisiertes Objekt nicht aufrufen."

Hinweise

Sie können diese Methode aufrufen, um CES zu entfernen. Da Sie jedoch die UnInstall-Methode für ein bereits initialisiertes ICertificateEnrollmentServerSetup-Objekt nicht aufrufen können, müssen Sie vor dem Aufrufen von UnInstall eine neue ICertificateEnrollmentServerSetup erstellen.

Diese Methode versucht, alle CES-bezogenen Verzeichnisse und den Anwendungspool zu löschen. Wenn dies nicht möglich ist, wird weiterhin S_OK zurückgegeben, aber Sie können die ErrorString-Eigenschaft überprüfen, um zu ermitteln, welche Probleme bei der Methode aufgetreten sind.

Diese Funktion führt die folgenden Aktionen aus:

Initialisiert die Windows-Verwaltungsinstrumentation (WMI).
Versucht, das Verzeichnis %windir%\systemdata\ces und alle möglicherweise vorhandenen Anwendungsunterverzeichnisse zu löschen. Weitere Informationen finden Sie im Abschnitt Installationsbemerkungen .
Versucht, den Anwendungspool und alle Anwendungen im Pool zu löschen.
Versucht, den Sicherheitsdeskriptor des Containers "Gelöschte Objekte" in Active Directory zu aktualisieren, um den Zugriff durch den Computer zu verweigern. Weitere Informationen finden Sie im Abschnitt Installationsbemerkungen .

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

ICertificateEnrollmentServerSetup

Freigeben über