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

  • Artigo

O método UnInstall remove o serviço Web CEP (Política de Registro de Certificado).

Sintaxe

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

Parâmetros

[in, optional] pAuthKeyBasedRenewal

Um ponteiro para uma matriz VARIANT que contém o tipo de autenticação e os valores opcionais KeyBasedRenewal.

Você pode definir os valores a seguir para o tipo de autenticação no primeiro elemento da matriz.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
O segundo elemento (opcional) no valor da matriz é VARIANT_TRUE para um CEP KeyBasedRenewal.

Retornar valor

Código de retorno Descrição
E_ACCESSDENIED
 O usuário deve ser um administrador local.

O valor da propriedade ErrorString é definido como "Você precisa ser o administrador do computador local para executar essa configuração".
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 O objeto ICertificateEnrollmentPolicyServerSetup foi inicializado. Um objeto é inicializado quando você chama InitializeInstallDefaults com êxito.

O valor da propriedade ErrorString é definido como "O objeto foi inicializado. Não é possível chamar UnInstall em um objeto inicializado."

Comentários

Você pode chamar esse método para remover o serviço CEP. No entanto, como você não pode chamar o método UnInstall em um objeto ICertificateEnrollmentPolicyServerSetup que já foi inicializado, você deve criar um novo ICertificateEnrollmentPolicyServerSetup antes de chamar UnInstall.

Quando o parâmetro pAuthKeyBasedRenewal é NULL, essa função executa as seguintes ações:

  • Inicializa a Instrumentação de Gerenciamento do Windows (WMI).
  • Tenta excluir o diretório %Windir%\Systemdata\Cep e todos os subdiretórios de aplicativos que podem existir. Para obter mais informações, consulte a seção Instalar Comentários.
  • Tenta excluir o pool de aplicativos e todos os aplicativos no pool.
  • Tenta atualizar o descritor de segurança do contêiner Objetos Excluídos no Active Directory para negar o acesso pelo computador. Para obter mais informações, consulte a seção Instalar Comentários.
Quando o parâmetro pAuthKeyBasedRenewal contém valores para o tipo de autenticação e KeyBasedRenewal, essa função executa as ações na lista anterior, mas exclui apenas o aplicativo que corresponde aos valores definidos em pAuthKeyBasedRenewal e deixa outros aplicativos em vigor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho casetup.h
DLL Certocm.dll

Confira também

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Instalar