Compartilhar via


Método ICertificateEnrollmentServerSetup::InitializeInstallDefaults (casetup.h)

O método InitializeInstallDefaults inicializa o objeto ICertificateEnrollmentServerSetup com uma configuração padrão.

Sintaxe

HRESULT InitializeInstallDefaults();

Retornar valor

Código de retorno Descrição
E_ACCESSDENIED
Um usuário deve ser um administrador da raiz do domínio ou da empresa. Um computador deve ser ingressado no domínio.

Se o usuário não for uma raiz de domínio ou administrador corporativo, a propriedade ErrorString será definida como:

"Você deve ser membro do grupo administradores corporativos para executar a Instalação."

Se o computador não estiver associado ao domínio, a propriedade ErrorString será definida como:

"O Serviço Web de Registro de Certificado ou o Serviço Web de Política de Registro de Certificado não pode ser instalado em um computador que não seja membro de um domínio."

HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
O objeto ICertificateEnrollmentServerSetup já foi inicializado. A propriedade ErrorString está definida como:

"O objeto de instalação já foi inicializado. Este objeto não pode ser inicializado mais de uma vez."

Comentários

Esse método executa as seguintes ações:

  • Determina se o objeto ICertificateEnrollmentServerSetup já foi inicializado.
    Nota Se esse marcar falhar, o método definirá a propriedade ErrorString como "O objeto de instalação já foi inicializado. Este objeto não pode ser inicializado mais de uma vez."
     
  • Determina se o usuário é um administrador da raiz do domínio ou da empresa.
    Nota Se esse marcar falhar, o método definirá a propriedade ErrorString como "Você deve ser um membro do grupo Administradores corporativos para executar a Instalação".
     
  • Determina se o computador está ingressado no domínio.
    Nota Se esse marcar falhar, o método definirá a propriedade ErrorString como "O Serviço Web de Registro de Certificado ou o Serviço Web de Política de Registro de Certificado não pode ser instalado em um computador que não seja membro de um domínio".
     
  • Define o procedimento de autenticação padrão como Kerberos. Você pode chamar SetProperty para alterar o método de autenticação.
  • Determina se o CES está instalado em um computador que executa o Windows Server 2008 R2.
    Nota Se esse marcar falhar, o método definirá a propriedade ErrorString como "O Serviço Web de Registro de Certificado ou o Serviço Web de Política de Registro de Certificado deve ser instalado em um servidor membro em uma floresta do Active Directory na qual a versão do Windows Server 2008 R2 do ADPrep /forestprep foi executada com êxito.".
     
  • Define o contexto de servidor padrão para a conta interna ApplicationPoolIdentity .
  • Define a propriedade ENUM_CESSETUPPROP_RENEWALONLY como FALSE.
  • Define que a propriedade ENUM_CESSETUPPROP_URL será "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces" se houver uma configuração de AC (autoridade de certificação) válida. Se uma configuração válida não existir, a propriedade ENUM_CESSETUPPROP_URL não será definida. O SanitizedCAShortName é o nome curto higienizado da AC. Para obter mais informações sobre nomes sanitizados, consulte GetConfig.
    Nota Se a autoridade de certificação for uma AC autônoma, a propriedade ErrorString será definida como "O Serviço Web de Registro de Certificado não pode ser usado com uma AC (autoridade de certificação) autônoma. Ele só pode ser usado com uma AC corporativa."
     
Você deve chamar o método InitializeInstallDefaults antes de chamar qualquer método diferente de UnInstall. Chame o método Install para instalar o serviço configurado. Chame UnInstall em um novo objeto ICertificateEnrollmentServerSetup para remover o serviço.

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

CESSetupProperty

ICertificateEnrollmentServerSetup