Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

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:


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.

Return value

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]





Community Additions

© 2015 Microsoft