IX509CertificateRequestPkcs7::InitializeFromTemplateName (certenroll.h)

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

Syntax

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 ejecuta 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, entre otros, los de la tabla siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Observaciones

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:

• CspInformations
• ParentWindow
• Silent
• UIContextMessage

• Colección ICryptAttributes .
• Colección IX509Extensions .
• Una colección IObjectIds rellenada con los identificadores de objeto XCN_OID_KEY_USAGE y XCN_OID_BASIC_CONSTRAINTS2 predeterminados.
• 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:

• Agrega las extensiones especificadas por la plantilla a la colección IX509Extensions .
• Quita las extensiones críticas predeterminadas (XCN_OID_KEY_USAGE y XCN_OID_BASIC_CONSTRAINTS2) de la colección si la plantilla indica que no son críticas. Se agregan los OID marcados como críticos por la plantilla.
• Establece la propiedad SmimeCapabilities si la plantilla admite algoritmos simétricos.
• Establece la propiedad AlternateSignatureAlgorithm si la plantilla requiere un OID de algoritmo de firma discreto.
• Crea un objeto IX509SignatureInformation .
• Crea un OID de algoritmo hash si el algoritmo se especifica en la plantilla y lo establece en el objeto IX509SignatureInformation .
• Crea un OID de algoritmo de cifrado asimétrico si el algoritmo se especifica en la plantilla y lo establece en el objeto IX509SignatureInformation .
• Establece las siguientes propiedades IX509PrivateKey de la configuración de la plantilla:
  • KeySpec
  • KeyUsage
  • Longitud
  • Política de exportación
  • KeyProtection
  • SecurityDescriptor
  • Silent
  • MachineContext
  • Algoritmo

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

Consulte también

IX509CertificateRequestPkcs7