struttura CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA (wincrypt.h)

  • Articolo

La struttura CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA contiene informazioni utilizzate per verificare una firma del messaggio. Contiene l'indice del firmatario e la chiave pubblica del firmatario. La chiave pubblica del firmatario può essere la struttura CERT_PUBLIC_KEY_INFO del firmatario, il contesto del certificato o il contesto della catena.

Sintassi

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

Dimensione, in byte, della struttura.

hCryptProv

Questo membro non viene usato e deve essere impostato su NULL.

Windows Server 2003 e Windows XP: Handle per il provider di crittografia usato per verificare la firma. Se NULL, viene usato il provider di crittografia specificato in CryptMsgOpenToDecode . Se anche hCryptProv in CryptMsgOpenToDecode è NULL, viene usato il provider predefinito in base all'identificatore OID (Public Key Object Identifier) del firmatario . Il tipo di dati di questo membro è HCRYPTPROV.

dwSignerIndex

Indice del firmatario nel messaggio.

dwSignerType

Struttura che contiene le informazioni sul firmatario. Nella tabella seguente vengono illustrati i valori predefiniti e le strutture indicate.

Valore Significato
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

Puntatore a una struttura CERT_PUBLIC_KEY_INFO , un contesto del certificato, un contesto di catena o NULL a seconda del valore di dwSignerType.

Commenti

Se dwSignerType è CMSG_VERIFY_SIGNER_NULL, la firma deve contenere solo gli ottetti hash non crittografati.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione wincrypt.h