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

  • Artículo

El método GetProperty recupera un valor de enumeración CESSetupProperty para la configuración del servicio web de inscripción de certificados (CES).

Sintaxis

HRESULT GetProperty(
  [in]  CESSetupProperty propertyId,
  [out] VARIANT          *pPropertyValue
);

Parámetros

[in] propertyId

Valor de enumeración CESSetupProperty que especifica el valor de propiedad que se va a recuperar. Para obtener más información, vea la sección Comentarios.

[out] pPropertyValue

Puntero a una variable VARIANT que contiene el valor de la propiedad.

Valor devuelto

Código devuelto Descripción
E_INVALIDARG
 El argumento propertyId no es miembro del tipo de enumeración CESSetupProperty .
E_POINTER
 El parámetro pPropertyValue no puede ser NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 El objeto ICertificateEnrollmentServerSetup no se ha inicializado.

El valor de la propiedad ErrorString se establece en "El objeto de instalación no se ha inicializado. Inicialice el objeto de instalación con el método InitializeInstallDefaults".

Comentarios

El tipo de enumeración CESSetupProperty contiene los valores siguientes:

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

Estos valores tienen los significados siguientes:

  • La propiedad ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY es un valor VT_BOOL que especifica si el contexto del servidor es ApplicationPoolIdentity.
  • La propiedad ENUM_CESSETUPPROP_CACONFIG contiene una cadena de configuración de entidad de certificación (CA) (VT_BSTR) del formulario computerDNSnameCAName, donde computerDNSname/ es el nombre DNS completo del servidor y CAName es el nombre común de la ENTIDAD de certificación.
  • La propiedad ENUM_CESSETUPPROP_AUTHENTICATION especifica el tipo de procedimiento de autenticación utilizado. Si el método GetProperty devuelve correctamente, el argumento pPropertyValue contendrá una de las siguientes constantes:
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • La propiedad ENUM_CESSETUPPROP_SSLCERTHASH contiene el hash (VT_BSTR) del certificado usado durante la autenticación. La propiedad ENUM_CESSETUPPROP_AUTHENTICATION debe establecerse en X509AuthCertificate.
  • La propiedad ENUM_CESSETUPPROP_URL contiene la dirección URL del servicio CES. Si el método GetProperty devuelve correctamente, el argumento pPropertyValue contendrá un subtipo VT_BSTR que contiene una dirección URL del formulario "https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces", donde el tipo de autenticación puede ser uno de los siguientes:
    • Kerberos
    • usernamepassword
    • certificado
  • La propiedad ENUM_CESSETUPPROP_RENEWALONLY es un valor de VT_BOOL que especifica si CES solo puede procesar renovaciones de certificados.

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

ICertificateEnrollmentServerSetup