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

  • Artículo

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

Sintaxis

HRESULT SetProperty(
  [in] CEPSetupProperty propertyId,
  [in] 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_AUTHENTICATION debe establecerse en X509AuthCertificate.
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 No se puede especificar este valor.

[in] pPropertyValue

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

Si especifica ENUM_CEPSETUPPROP_AUTHENTICATION en el parámetro propertyId , el subtipo VARIANT debe ser VT_I2, VT_I4 o VT_UII4, y el argumento pPropertyValue debe ser una de las siguientes constantes:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Si especifica ENUM_CEPSETUPPROP_SSLCERTHASH en el parámetro propertyId , debe establecer el parámetro pPropertyValue en un subtipo VT_BSTR que contenga un hash del certificado usado para la autenticación.

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 o ha intentado establecer el valor de ENUM_CEPSETUPPROP_URL .
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".
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Si va a establecer la propiedad ENUM_CEPSETUPPROP_AUTHENTICATION , el subtipo VARIANT debe ser VT_I2, VT_I4 o VT_UI4.

Comentarios

Debe llamar a InitializeInstallDefaults antes de llamar al método SetProperty .

Requisitos

   
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

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults