CryptGetSignerCertificateCallback callback function
The CryptGetSignerCertificateCallback user supplied callback function is used with the CRYPT_VERIFY_MESSAGE_PARA structure to get and verify a message signer's certificate.
PCCERT_CONTEXT WINAPI CryptGetSignerCertificateCallback( _In_ void *pvGetArg, _In_ DWORD dwCertEncodingType, _In_ PCERT_INFO pSignerId, _In_ HCERTSTORE hMsgCertStore );
- pvGetArg [in]
A pointer to user-defined data passed on to the verification function as specified in the CRYPT_VERIFY_MESSAGE_PARA structure.
- dwCertEncodingType [in]
Specifies the type of encoding used. It is always acceptable to specify both the certificate and message encoding types by combining them with a bitwise-OR operation as shown in the following example:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
Currently defined encoding types are:
- pSignerId [in]
A pointer to a CERT_INFO structure containing the issuer and serial number. Can be NULL if there is no content or signer.
- hMsgCertStore [in]
A handle to the certificate store containing all the certificates and CRLs in the signed message.
If a signer certificate is found, the function returns a pointer to a read-only CERT_CONTEXT. The returned CERT_CONTEXT was obtained either from a certificate store or was created using CertCreateCertificateContext. In either case, it must be freed using CertFreeCertificateContext. If this function fails, the return value is NULL.
If the message does not contain content or signers, the function is called with pSignerId set to NULL.
Minimum supported client
|Windows XP [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|