Compartir a través de

Ix509EnrollmentPolicyServer::Initialize (certenroll.h)

  • Artículo

El método Initialize inicializa un objeto IX509EnrollmentPolicyServer .

Sintaxis

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

Parámetros

[in] bstrPolicyServerUrl

Variable BSTR que contiene la dirección URL del servidor de directivas de inscripción de certificados.

[in] bstrPolicyServerId

Variable BSTR que contiene un identificador único para el servidor de directivas de inscripción de certificados. Si este valor no es NULL, debe coincidir con la cadena de identificador devuelta por la respuesta CEP.

[in] authFlags

Valor de enumeración X509EnrollmentAuthFlags que especifica el tipo de autenticación de cliente. Puede ser uno de los siguientes valores.

Valor Significado
X509AuthAnonymous
 Autenticación anónima.
X509AuthKerberos
 Autenticación Kerberos.
X509AuthUsername
 Borrar el nombre de usuario y la autenticación de contraseñas de texto.
Nota El nombre de usuario y la contraseña se cifran antes de la transmisión y se almacenan de forma segura en el almacén de credenciales en el servidor CEP.
 
X509AuthCertificate
 Certificado de autenticación de cliente instalado en el equipo local y usado por el servidor para comprobar la identidad del cliente.

[in] fIsUnTrusted

Valor booleano que especifica si se permiten certificados de entidad de certificación que no son de confianza.

[in] context

Valor de enumeración X509CertificateEnrollmentContext que especifica la naturaleza de la entidad final para la que está prevista la inscripción de certificados. Puede ser uno de los siguientes valores.

Valor Significado
ContextUser
 El certificado está pensado para un usuario final.
ContextMachine
 El certificado está pensado para un equipo.
ContextAdministratorForceMachine
 Un administrador que actúa en nombre de un equipo solicita el certificado.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
E_INVALIDARG
 El parámetro bstrPolicyServerUrl no puede ser una cadena vacía y debe representar una dirección URL HTTPS.
E_OUTOFMEMORY
 No había suficiente memoria disponible para las cadenas especificadas en los parámetros bstrPolicyServerUrl o bstrPolicyServerId .
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto IX509EnrollmentPolicyServer ya se ha inicializado.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 El valor especificado en el parámetro bstrPolicyServerId no es NULL y no es igual al valor del identificador CEP existente en el servidor CEP.

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 certenroll.h

Consulte también

IX509EnrollmentPolicyServer