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

  • Artículo

El método InitializeFromTemplateName inicializa el objeto de inscripción a partir de un nombre común (CN) de plantilla.

Sintaxis

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

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.

[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.

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto de inscripción ya se ha inicializado.

Comentarios

El método InitializeFromTemplateName :

  • 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 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