Compartir a través de

Método IX509EnrollmentHelper::Enroll (certenroll.h)

  • Artículo

El método Enroll inscribe una solicitud de certificado y recupera el certificado emitido. Este método está habilitado para web.

Sintaxis

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Parámetros

[in] strEnrollmentPolicyServerURI

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

[in] strTemplateName

Variable BSTR que contiene el nombre común (CN) de la plantilla tal como aparece en Active Directory o el identificador de objeto decimal punteado.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación aplicada a una matriz de bytes con fines de presentación.

[in] enrollFlags

Valor de enumeración WebEnrollmentFlags que especifica el comportamiento de la inscripción web. Puede ser el siguiente valor.

Valor Significado
EnrollPrompt
 Si se establece esta marca y no hay credenciales de autenticación disponibles para el servidor de inscripción de certificados, el servicio de certificados solicita una credencial. Si no hay ninguna credencial de autenticación y no se establece esta marca, se produce un error en el método Enroll .

[out, retval] pstrCertificate

Un BSTR que contiene el certificado emitido.

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
 Los parámetros strEnrollmentPolicyServerURI y strTemplateName no pueden ser NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)
 Los parámetros strEnrollmentPolicyServerURI y strTemplateName superan los 64 000 caracteres o contienen caracteres NULL incrustados.

Comentarios

El método Enroll recupera la plantilla adecuada, llama a InitializeFromTemplate y, a continuación, llama a Enroll en el objeto IX509Enrollment .

Este método no instala el certificado emitido.

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

IX509EnrollmentHelper