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

  • Artículo

El método Enroll codifica una solicitud, la envía a una entidad de certificación (CA) adecuada e instala la respuesta.

Sintaxis

HRESULT Enroll();

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 o valor devuelto Descripción
OLE_E_BLANK
 El objeto de inscripción no se ha inicializado.

Comentarios

El método puede crear un par de claves si es necesario. En función de cómo inicialice el objeto de inscripción y de las propiedades que establezca, puede que no sea necesario crear un par de claves. Por ejemplo, si va a renovar un certificado mediante una clave existente o si el objeto IX509PrivateKey asociado a la solicitud de certificado representa una clave existente, este método no crea un nuevo par de claves.

Antes de inscribirse, debe inicializar el objeto IX509Enrollment llamando a uno de los métodos siguientes.

Si la operación de inscripción se realiza correctamente, la función devuelve S_OK. Sin embargo, esto no significa necesariamente que la respuesta de la ENTIDAD de certificación se haya instalado. Llame a la propiedad Status para determinar el estado de inscripción.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IX509Enrollment