Compartir a través de


IX509CertificateRequestPkcs7::InitializeFromTemplateName (certenroll.h)

El método InitializeFromTemplateName inicializa la solicitud de certificado mediante una plantilla.

Sintaxis

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

Parámetros

[in] Context

Valor de enumeración X509CertificateEnrollmentContext que especifica si el certificado solicitado está pensado para un usuario final, un equipo o un administrador que actúa en nombre del 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
ERROR_ALREADY_INITIALIZED
El objeto de solicitud de certificado ya se ha inicializado.

Comentarios

El método InitializeFromTemplateName crea un objeto de solicitud PKCS #7 y establece las siguientes propiedades en los valores que existían antes de llamar a este método:

El método crea las siguientes colecciones:
  • Colección ICryptAttributes .
  • Una colección IX509Extensions .
  • Colección IObjectIds rellenada con el XCN_OID_KEY_USAGE predeterminado y XCN_OID_BASIC_CONSTRAINTS2 identificadores de objeto.
  • Colección IObjectIds vacía para los OID de atributo y extensión que se van a suprimir de la nueva solicitud.

A continuación, el método examina la plantilla y realiza las siguientes acciones:

Si la propiedad CSPInformations es NULL, el método crea una colección ICspInformations a partir de los proveedores instalados en el equipo.

Por último, el método establece la solicitud PKCS #10 inicializada como el objeto de solicitud interno.

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

IX509CertificateRequestPkcs7