Edit

Share via

CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA structure (wincrypt.h)

  • Article

The CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA structure contains information used to verify a message signature. It contains the signer index and signer public key. The signer public key can be the signer's CERT_PUBLIC_KEY_INFO structure, certificate context, or chain context.

Syntax

typedef struct _CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA {
  DWORD             cbSize;
  HCRYPTPROV_LEGACY hCryptProv;
  DWORD             dwSignerIndex;
  DWORD             dwSignerType;
  void              *pvSigner;
} CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA, *PCMSG_CTRL_VERIFY_SIGNATURE_EX_PARA;

Members

cbSize

The size, in bytes, of this structure.

hCryptProv

This member is not used and should be set to NULL.

Windows Server 2003 and Windows XP:  A handle to the cryptographic provider used to verify the signature. If NULL, the cryptographic provider specified in CryptMsgOpenToDecode is used. If the hCryptProv in CryptMsgOpenToDecode is also NULL, the default provider according to the signer's public key object identifier (OID) is used.This member's data type is HCRYPTPROV.

dwSignerIndex

The index of the signer in the message.

dwSignerType

The structure that contains the signer information. The following table shows the predefined values and the structures indicated.

Value Meaning
CMSG_VERIFY_SIGNER_PUBKEY

CERT_PUBLIC_KEY_INFO
CMSG_VERIFY_SIGNER_CERT

CERT_CONTEXT
CMSG_VERIFY_SIGNER_CHAIN

CERT_CHAIN_CONTEXT
CMSG_VERIFY_SIGNER_NULL
 NULL

pvSigner

A pointer to a CERT_PUBLIC_KEY_INFO structure, a certificate context, a chain context, or NULL depending on the value of dwSignerType.

Remarks

If dwSignerType is CMSG_VERIFY_SIGNER_NULL, the signature is expected to contain only the unencrypted hash octets.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h