Compartir a través de

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

  • Artículo

El método InitializeInstallDefaults inicializa el objeto ICertificateEnrollmentServerSetup con una configuración predeterminada.

Sintaxis

HRESULT InitializeInstallDefaults();

Valor devuelto

Código devuelto Descripción
E_ACCESSDENIED
 Un usuario debe ser administrador de la raíz del dominio o de la empresa. Un equipo debe estar unido al dominio.

Si el usuario no es una raíz de dominio o administrador de empresa, la propiedad ErrorString se establece en:

"Debe ser miembro del grupo Administradores de empresa para ejecutar el programa de instalación".

Si el equipo no está unido al dominio, la propiedad ErrorString se establece en:

"El servicio web de inscripción de certificados o el servicio web de directiva de inscripción de certificados no se puede instalar en un equipo que no sea miembro de un dominio".
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 El objeto ICertificateEnrollmentServerSetup ya se ha inicializado. La propiedad ErrorString se establece en:

"El objeto de instalación ya se ha inicializado. Este objeto no se puede inicializar más de una vez".

Comentarios

Este método realiza las siguientes acciones:

  • Determina si el objeto ICertificateEnrollmentServerSetup ya se ha inicializado.
    Nota Si se produce un error en esta comprobación, el método establece la propiedad ErrorString en "El objeto de instalación ya se ha inicializado. Este objeto no se puede inicializar más de una vez".
     
  • Determina si el usuario es administrador de la raíz del dominio o de la empresa.
    Nota Si se produce un error en esta comprobación, el método establece la propiedad ErrorString en "Debe ser miembro del grupo Administradores de empresa para ejecutar el programa de instalación".
     
  • Determina si el equipo está unido al dominio.
    Nota Si se produce un error en esta comprobación, el método establece la propiedad ErrorString en "El servicio web de inscripción de certificados o el servicio web de directiva de inscripción de certificados no se puede instalar en un equipo que no sea miembro de un dominio".
     
  • Establece el procedimiento de autenticación predeterminado en Kerberos. Puede llamar a SetProperty para cambiar el método de autenticación.
  • Determina si CES está instalado en un equipo que ejecuta Windows Server 2008 R2.
    Nota Si se produce un error en esta comprobación, el método establece la propiedad ErrorString en "El servicio web de inscripción de certificados o el servicio web de directiva de inscripción de certificados debe instalarse en un servidor miembro en un bosque de Active Directory en el que se ha ejecutado correctamente la versión de Windows Server 2008 R2 de ADPrep /forestprep".
     
  • Establece el contexto de servidor predeterminado en la cuenta integrada ApplicationPoolIdentity .
  • Establece la propiedad ENUM_CESSETUPPROP_RENEWALONLY en FALSE.
  • Establece la propiedad ENUM_CESSETUPPROP_URL es "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces" si existe una configuración válida de entidad de certificación (CA). Si no existe una configuración válida, no se establece la propiedad ENUM_CESSETUPPROP_URL. SanitizedCAShortName es el nombre corto saneado de la ENTIDAD de certificación. Para obtener más información sobre los nombres saneados, vea GetConfig.
    Nota Si la entidad de certificación es una ENTIDAD de certificación independiente, la propiedad ErrorString se establece en "El servicio web de inscripción de certificados no se puede usar con una entidad de certificación independiente (CA). Solo se puede usar con una ENTIDAD de certificación empresarial".
     
Debe llamar al método InitializeInstallDefaults antes de llamar a cualquier método que no sea UnInstall. Llame al método Install para instalar el servicio configurado. Llame a UnInstall en un nuevo objeto ICertificateEnrollmentServerSetup para quitar el servicio.

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

CESSetupProperty

ICertificateEnrollmentServerSetup