Compartir a través de

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

  • Artículo

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

Sintaxis

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

Parámetros

[in] propertyId

Valor de la enumeración CEPSetupProperty que especifica el valor de propiedad que se va a establecer. Los valores siguientes son válidos.

Valor Descripción
ENUM_CEPSETUPPROP_AUTHENTICATION El parámetro pPropertyValue contiene un valor que identifica el tipo de autenticación que se va a usar.
ENUM_CEPSETUPPROP_SSLCERTHASH El parámetro pPropertyValue contiene un hash del certificado, si existe, que se usa durante la autenticación.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL El parámetro pPropertyValue especifica si se debe configurar el servidor de directivas de inscripción en un modo que devuelva directivas solo para las plantillas keyBasedRenewal.
ENUM_CEPSETUPPROP_URL Contiene la dirección URL del servicio CEP. 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_cep_AuthenticationType/service.svc/cep", donde el tipo de autenticación puede ser uno de los siguientes:
  • Kerberos
  • usernamepassword
  • certificado

[out] pPropertyValue

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

Si especifica ENUM_CEPSETUPPROP_AUTHENTICATION en el parámetro propertyId , el parámetro pPropertyValue contendrá una de las siguientes constantes si el método GetProperty devuelve correctamente:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Si especifica ENUM_CEPSETUPPROP_SSLCERTHASH en el parámetro propertyId , el parámetro pPropertyValue contendrá un subtipo VT_BSTR que contiene el hash si el método GetProperty devuelve correctamente.

Si especifica ENUM_CEPSETUPPROP_AUTHENTICATION en el parámetro propertyId , el parámetro pPropertyValue contiene el procedimiento de autenticación.

Si especifica ENUM_CEPSETUPPROP_URL en el parámetro propertyId , el parámetro pPropertyValue contiene la dirección URL del servicio web de directiva de inscripción de certificados (CEP).

Si especifica ENUM_CEPSETUPPROP_KEYBASED_RENEWAL en el parámetro propertyId , debe establecer el parámetro pPropertyValue en el subtipo VT_BOOL que indica si se va a configurar el servidor de directivas de inscripción en un modo que devuelva directivas solo para las plantillas de KeyBasedRenewal.

Valor devuelto

Código devuelto Descripción
E_INVALIDARG
 El argumento propertyId no es miembro del tipo de enumeración CEPSetupProperty .
E_POINTER
 El parámetro pPropertyValue no puede ser NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 El objeto ICertificateEnrollmentPolicyServerSetup 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".

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

SetProperty