Freigeben über

ICertificateEnrollmentPolicyServerSetup::UnInstall-Methode (casetup.h)

  • Artikel

Die UnInstall-Methode entfernt den CEP-Webdienst (Certificate Enrollment Policy).

Syntax

HRESULT UnInstall(
  [in, optional] VARIANT *pAuthKeyBasedRenewal
);

Parameter

[in, optional] pAuthKeyBasedRenewal

Ein Zeiger auf ein VARIANT-Array , das den Authentifizierungstyp und die optionalen KeyBasedRenewal-Werte enthält.

Sie können die folgenden Werte für den Authentifizierungstyp im ersten Element des Arrays festlegen.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
Das zweite (optionale) Element im Arraywert ist VARIANT_TRUE für eine KeyBasedRenewal-CEP.

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 ICertificateEnrollmentPolicyServerSetup-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 den CEP-Dienst zu entfernen. Da Sie jedoch die UnInstall-Methode für ein bereits initialisiertes ICertificateEnrollmentPolicyServerSetup-Objekt nicht aufrufen können, müssen Sie vor dem Aufrufen von UnInstall eine neue ICertificateEnrollmentPolicyServerSetup erstellen.

Wenn der pAuthKeyBasedRenewal-Parameter NULL ist, führt diese Funktion die folgenden Aktionen aus:

  • Initialisiert die Windows-Verwaltungsinstrumentation (WMI).
  • Versucht, das Verzeichnis %Windir%\Systemdata\Cep 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 .
Wenn der Parameter pAuthKeyBasedRenewal Werte für den Authentifizierungstyp und KeyBasedRenewal enthält, führt diese Funktion die Aktionen in der vorherigen Liste aus, löscht jedoch nur die Anwendung, die den in pAuthKeyBasedRenewal festgelegten Werten entspricht, und belässt andere Anwendungen.

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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Installieren