IX509CertificateRequestCmc ::get_SignatureInformation, méthode (certenroll.h)
La propriété SignatureInformation récupère l’objet IX509SignatureInformation qui contient des informations sur la signature principale utilisée pour signer la demande de certificat. Cette propriété est activée sur le web.
Cette propriété est en lecture seule.
Syntaxe
HRESULT get_SignatureInformation(
IX509SignatureInformation **ppValue
);
Paramètres
ppValue
Valeur de retour
None
Remarques
L’objet IX509SignatureInformation contient des informations sur le hachage, la clé publique et les algorithmes de signature utilisés pour la signature primaire qui signe la demande de certificat. Une requête CMC peut avoir une signature primaire plus aucune ou plusieurs signatures basées sur un certificat. Les signatures basées sur des certificats peuvent être incluses dans une demande si, par exemple, une ou plusieurs parties supplémentaires doivent se porter garantes de l’identité de l’entité qui demande le nouveau certificat. Vous pouvez appeler la propriété SignerCertificates pour récupérer une collection de ces signatures supplémentaires basées sur des certificats.
La signature primaire est généralement créée à l’aide de la clé privée qui correspond à la clé publique dans l’objet de requête PKCS #10 interne. Étant donné que la clé privée est généralement créée pour inscrire une nouvelle requête dans une hiérarchie de certificats, la signature principale n’est pas basée sur un certificat et vous devez appeler la propriété SignatureInformation pour la récupérer.
Si l’objet IX509SignatureInformation n’existe pas lorsque la propriété SignatureInformation est appelée ou que la création de la signature a été différée lors de l’initialisation, cette propriété :
- Récupère l’objet de requête PKCS #10 le plus interne.
- Récupère et dupliquez les informations de signature de la requête interne.
- Tente de récupérer la clé privée associée au PKCS #10 interne et définit la propriété NullSigned si aucune clé privée n’est trouvée.
- Récupère l’algorithme de hachage, le cas échéant, à partir du modèle associé à la requête interne et définit la propriété HashAlgorithm .
- Récupère l’algorithme asymétrique, le cas échéant, à partir de la clé privée associée à la requête interne et définit la propriété PublicKeyAlgorithm .
- Récupère les indicateurs de clé privée du modèle et définit l’élément AlternateSignatureAlgorithm le cas échéant.
Vous devez initialiser l’objet de requête CMC avant d’appeler cette propriété. Pour plus d'informations, voir les rubriques suivantes :
- Initialiser
- InitializeDecode
- InitializeFromCertificate
- InitializeFromInnerRequest
- InitializeFromInnerRequestTemplateName
- InitializeFromTemplateName
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certenroll.h |
| DLL | CertEnroll.dll |