Edit

Share via

ICertificateEnrollmentServerSetup::UnInstall method (casetup.h)

  • Article

The UnInstall method removes the Certificate Enrollment Web Service (CES).

Syntax

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

Parameters

pCAConfig

This parameter is reserved for future use.

pAuthentication

This parameter is reserved for future use.

Return value

Return code Description
E_ACCESSDENIED
 The user must be a local administrator.

The ErrorString property value is set to "You have to be the local machine administrator in order to run this setup."
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 The ICertificateEnrollmentServerSetup object has been initialized. An object is initialized when you successfully call InitializeInstallDefaults.

The ErrorString property value is set to "The object has been initialized. You cannot call UnInstall on an initialized object."

Remarks

You can call this method to remove CES. However, because you cannot call the UnInstall method on an ICertificateEnrollmentServerSetup object that has already been initialized, you must create a new ICertificateEnrollmentServerSetup before calling UnInstall.

This method attempts to delete all CES-related directories and the application pool. If it is unable to do so, it still returns S_OK, but you can check the ErrorString property to determine what problems the method encountered.

This function performs the following actions:

  • Initializes Windows Management Instrumentation (WMI).
  • Attempts to delete the %windir%\systemdata\ces directory and all application subdirectories that may exist. For more information, see the Install Remarks section.
  • Attempts to delete the application pool and all applications in the pool.
  • Attempts to update the security descriptor of the Deleted Objects container in Active Directory to deny access by the computer. For more information, see the Install Remarks section.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header casetup.h
DLL Certocm.dll

See also

ICertificateEnrollmentServerSetup