SIGNER_DIGEST_SIGN_INFO structure

The SIGNER_DIGEST_SIGN_INFO structure contains information about digest signing. It contains a pointer to a digest signing function implemented within the provided dll, specified by the dwDigestSignChoice.

Note

This structure is not defined in any header file. To use this structure, you must define it yourself as shown in this topic.

Syntax

typedef struct _SIGNER_DIGEST_SIGN_INFO
{
    DWORD cbSize;                                                
    DWORD dwDigestSignChoice;                                    
    union
    {
		PFN_AUTHENTICODE_DIGEST_SIGN pfnAuthenticodeDigestSign;                                   
        	PFN_AUTHENTICODE_DIGEST_SIGN_WITHFILEHANDLE pfnAuthenticodeDigestSignWithFileHandle;      
        PFN_AUTHENTICODE_DIGEST_SIGN_EX pfnAuthenticodeDigestSignEx;                              
        PFN_AUTHENTICODE_DIGEST_SIGN_EX_WITHFILEHANDLE pfnAuthenticodeDigestSignExWithFileHandle; 
    };
    PCRYPT_DATA_BLOB pMetadataBlob;                              
    DWORD dwReserved;                                            
    DWORD dwReserved2;
    DWORD dwReserved3;
}SIGNER_DIGEST_SIGN_INFO, *PSIGNER_DIGEST_SIGN_INFO;

Members

cbSize

The size, in bytes, of the structure.

dwDigestSignChoice

Specifies which digest sign implementation to use.

Value	Meaning
DIGEST_SIGN 1 (0x1)	Use the DIGEST_SIGN implementation.
DIGEST_SIGN_WITHFILEHANDLE 2 (0x2)	Use the DIGEST_SIGN_WITHFILEHANDLE implementation.
DIGEST_SIGN_EX 3 (0x3)	Use the DIGEST_SIGN_EX implementation.
DIGEST_SIGN_EX_WITHFILEHANDLE 4 (0x4)	Use the DIGEST_SIGN_EX_WITHFILEHANDLE implementation.

pfnAuthenticodeDigestSign

Pointer to the PFN_AUTHENTICODE_DIGEST_SIGN callback function. Required if dwDigestSignChoice==DIGEST_SIGN.

pfnAuthenticodeDigestSignWithFileHandle

Pointer to the PFN_AUTHENTICODE_DIGEST_SIGN_WITHFILEHANDLE callback function. Required if dwDigestSignChoice==DIGEST_SIGN_WITHFILEHANDLE.

pfnAuthenticodeDigestSignEx

Pointer to the PFN_AUTHENTICODE_DIGEST_SIGN_EX callback function. Required if dwDigestSignChoice==DIGEST_SIGN_EX.

pfnAuthenticodeDigestSignExWithFileHandle

Pointer to the PFN_AUTHENTICODE_DIGEST_SIGN_EX_WITHFILEHANDLE callback function. Required if dwDigestSignChoice==DIGEST_SIGN_EX_WITHFILEHANDLE.

pMetadataBlob

Optional pointer to CRYPT_DATA_BLOB specifying metadata.

dwReserved

Reserved. This value must be zero (0).

dwReserved2

Reserved. This value must be zero (0).

dwReserved3

Reserved. This value must be zero (0).

Requirements

Requirement	Value
Minimum supported client	Windows 11 [desktop apps only]
DLL	Mssign32.dll