Método IX509CertificateRequestCmc::get_SignatureInformation (certenroll.h)
La propiedad SignatureInformation recupera el objeto IX509SignatureInformation que contiene información sobre la firma principal utilizada para firmar la solicitud de certificado. Esta propiedad está habilitada para web.
Esta propiedad es de solo lectura.
Sintaxis
HRESULT get_SignatureInformation(
IX509SignatureInformation **ppValue
);
Parámetros
ppValue
Valor devuelto
None
Observaciones
El objeto IX509SignatureInformation contiene información sobre los algoritmos hash, clave pública y firma usados para la firma principal que firma la solicitud de certificado. Una solicitud de CMC puede tener una firma principal más cero o más firmas basadas en certificados. Las firmas basadas en certificados se pueden incluir en una solicitud si, por ejemplo, una o varias partes adicionales deben responder a la identidad de la entidad que solicita el nuevo certificado. Puede llamar a la propiedad SignerCertificates para recuperar una colección de estas firmas adicionales basadas en certificados.
La firma principal se crea normalmente mediante la clave privada que coincide con la clave pública en el objeto de solicitud PKCS #10 interno. Dado que la clave privada se crea normalmente para inscribir una nueva solicitud en una jerarquía de certificados, la firma principal no está basada en certificados y debe llamar a la propiedad SignatureInformation para recuperarla.
Si el objeto IX509SignatureInformation no existe cuando se llama a la propiedad SignatureInformation o se aplaza la creación de la firma durante la inicialización, esta propiedad:
- Recupera el objeto de solicitud PKCS #10 más interno.
- Recupera y duplica la información de firma de la solicitud interna.
- Intenta recuperar la clave privada asociada al PKCS #10 interno y establece la propiedad NullSigned si no se encuentra ninguna clave privada.
- Recupera el algoritmo hash, si se especifica uno, de la plantilla asociada a la solicitud interna y establece la propiedad HashAlgorithm .
- Recupera el algoritmo asimétrico, si se especifica uno, de la clave privada asociada a la solicitud interna y establece la propiedad PublicKeyAlgorithm .
- Recupera las marcas de clave privada de la plantilla y establece AlternateSignatureAlgorithm si procede.
Debe inicializar el objeto de solicitud de CMC antes de llamar a esta propiedad. Para obtener más información, vea los temas siguientes:
- Inicialización
- InitializeDecode
- InitializeFromCertificate
- InitializeFromInnerRequest
- InitializeFromInnerRequestTemplateName
- InitializeFromTemplateName
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 |