Skip to content

Latest commit

 

History

History
141 lines (110 loc) · 5.67 KB

nf-casetup-icertificateenrollmentpolicyserversetup-uninstall.md

File metadata and controls

141 lines (110 loc) · 5.67 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:casetup.ICertificateEnrollmentPolicyServerSetup.UnInstall
ICertificateEnrollmentPolicyServerSetup::UnInstall (casetup.h)
Removes the Certificate Enrollment Policy (CEP) Web Service.
ICertificateEnrollmentPolicyServerSetup interface [Security]
UnInstall method
ICertificateEnrollmentPolicyServerSetup.UnInstall
ICertificateEnrollmentPolicyServerSetup::UnInstall
UnInstall
UnInstall method [Security]
UnInstall method [Security]
ICertificateEnrollmentPolicyServerSetup interface
casetup/ICertificateEnrollmentPolicyServerSetup::UnInstall
security.icertificateenrollmentpolicyserversetup_uninstall
security\icertificateenrollmentpolicyserversetup_uninstall.htm
security
3E53903A-B716-45E7-B0EB-0D1226291275
12/05/2018
ICertificateEnrollmentPolicyServerSetup interface [Security],UnInstall method, ICertificateEnrollmentPolicyServerSetup.UnInstall, ICertificateEnrollmentPolicyServerSetup::UnInstall, UnInstall, UnInstall method [Security], UnInstall method [Security],ICertificateEnrollmentPolicyServerSetup interface, casetup/ICertificateEnrollmentPolicyServerSetup::UnInstall, security.icertificateenrollmentpolicyserversetup_uninstall
casetup.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Casetup.idl
Certocm.dll
Windows
19H1
ICertificateEnrollmentPolicyServerSetup::UnInstall
casetup/ICertificateEnrollmentPolicyServerSetup::UnInstall
c++
APIRef
kbSyntax
COM
Certocm.dll
ICertificateEnrollmentPolicyServerSetup.UnInstall

ICertificateEnrollmentPolicyServerSetup::UnInstall

-description

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

-parameters

-param pAuthKeyBasedRenewal [in, optional]

A pointer to a VARIANT array that contains the authentication type and the optional KeyBasedRenewal values.

You can set the following values for authentication type in the first element of the array.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
The second (optional) element in the array value is VARIANT_TRUE for a KeyBasedRenewal CEP.

-returns

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 ICertificateEnrollmentPolicyServerSetup 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 the CEP service. However, because you cannot call the UnInstall method on an ICertificateEnrollmentPolicyServerSetup object that has already been initialized, you must create a new ICertificateEnrollmentPolicyServerSetup before calling UnInstall.

When the pAuthKeyBasedRenewal parameter is NULL, this function performs the following actions:

  • Initializes Windows Management Instrumentation (WMI).
  • Attempts to delete the %Windir%\Systemdata\Cep 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.
When the pAuthKeyBasedRenewal parameter contains values for the authentication type and KeyBasedRenewal, this function performs the actions in the previous list but it only deletes the application that corresponds to the values set in pAuthKeyBasedRenewal and leaves other applications in place.

-see-also

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Install