Compartir a través de

Método IX509Enrollment2::InitializeFromTemplate (certenroll.h)

  • Artículo

El método InitializeFromTemplate inicializa el objeto de inscripción mediante una plantilla.

Sintaxis

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Parámetros

[in] context

Valor de enumeración X509CertificateEnrollmentContext que indica si la inscripción solicitada es para un usuario, un equipo o un administrador que actúa en nombre de un equipo. Puede ser uno de los valores siguientes.

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

[in] pPolicyServer

Puntero a un objeto IX509EnrollmentPolicyServer que representa el servidor de directiva de inscripción de certificados (CEP) que contiene la plantilla especificada por el parámetro pTemplate .

[in] pTemplate

Puntero a un objeto IX509CertificateTemplate que representa la plantilla que se va a usar durante la inicialización.

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
E_POINTER
 Los parámetros pPolicyServer y pTemplate no pueden ser NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto de inscripción ya se ha inicializado.

Comentarios

Método InitializeFromTemplate :

  • Examina la plantilla para determinar el tipo de solicitud necesario.
  • Crea el tipo adecuado de objeto de solicitud (PKCS #10, PKCS #7 o CMC).
  • Establece las siguientes propiedades en la solicitud si los valores existen actualmente:
  • Inicializa el objeto de solicitud mediante la plantilla .
  • Recupera el número de firmas, las directivas de emisión y las directivas de aplicación de la plantilla.

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

IX509Enrollment2