Compartir a través de

Método ICertificateEnrollmentPolicyServerSetup::UnInstall (casetup.h)

  • Artículo

El método UnInstall quita el servicio web directiva de inscripción de certificados (CEP).

Sintaxis

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

Parámetros

[in, optional] pAuthKeyBasedRenewal

Puntero a una matriz VARIANT que contiene el tipo de autenticación y los valores opcionales de KeyBasedRenewal.

Puede establecer los siguientes valores para el tipo de autenticación en el primer elemento de la matriz.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
El segundo elemento (opcional) del valor de matriz es VARIANT_TRUE para un keyBasedRenewal CEP.

Valor devuelto

Código devuelto Descripción
E_ACCESSDENIED
 El usuario debe ser administrador local.

El valor de la propiedad ErrorString se establece en "Tiene que ser el administrador de la máquina local para ejecutar esta configuración".
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Se ha inicializado el objeto ICertificateEnrollmentPolicyServerSetup . Un objeto se inicializa cuando se llama correctamente a InitializeInstallDefaults.

El valor de la propiedad ErrorString se establece en "El objeto se ha inicializado. No se puede llamar a UnInstall en un objeto inicializado".

Comentarios

Puede llamar a este método para quitar el servicio CEP. Sin embargo, dado que no se puede llamar al método UnInstall en un objeto ICertificateEnrollmentPolicyServerSetup que ya se ha inicializado, debe crear un nuevo ICertificateEnrollmentPolicyServerSetup antes de llamar a UnInstall.

Cuando el parámetro pAuthKeyBasedRenewal es NULL, esta función realiza las siguientes acciones:

  • Inicializa Instrumental de administración de Windows (WMI).
  • Intenta eliminar el directorio %Windir%\Systemdata\Cep y todos los subdirectorios de aplicación que pueden existir. Para obtener más información, vea la sección Comentarios de instalación .
  • Intenta eliminar el grupo de aplicaciones y todas las aplicaciones del grupo.
  • Intenta actualizar el descriptor de seguridad del contenedor Objetos eliminados en Active Directory para denegar el acceso por parte del equipo. Para obtener más información, vea la sección Comentarios de instalación .
Cuando el parámetro pAuthKeyBasedRenewal contiene valores para el tipo de autenticación y KeyBasedRenewal, esta función realiza las acciones de la lista anterior, pero solo elimina la aplicación que corresponde a los valores establecidos en pAuthKeyBasedRenewal y deja en su lugar otras aplicaciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado casetup.h
Archivo DLL Certocm.dll

Consulte también

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Instalación