CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA-Struktur (wincrypt.h)

Artikel
03/03/2024

Die CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA-Struktur enthält Informationen, die zum Überprüfen einer Nachrichtensignatur verwendet werden. Es enthält den Signerindex und den öffentlichen Signaturschlüssel. Der öffentliche Schlüssel des Unterzeichners kann die CERT_PUBLIC_KEY_INFO Struktur, der Zertifikatkontext oder der Kettenkontext des Unterzeichners sein.

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;

Member

cbSize

Die Größe (in Bytes) dieser Struktur.

hCryptProv

Dieser Member wird nicht verwendet und sollte auf NULL festgelegt werden.

Windows Server 2003 und Windows XP: Ein Handle für den Kryptografieanbieter , der zum Überprüfen der Signatur verwendet wird. Bei NULL wird der in CryptMsgOpenToDecode angegebene Kryptografieanbieter verwendet. Wenn hCryptProv in CryptMsgOpenToDecode ebenfalls NULL ist, wird der Standardanbieter gemäß dem Public Key Object Identifier (OID) des Unterzeichners verwendet. Der Datentyp dieses Members ist HCRYPTPROV.

dwSignerIndex

Der Index des Signierers in der Nachricht.

dwSignerType

Die Struktur, die die Signiererinformationen enthält. Die folgende Tabelle zeigt die vordefinierten Werte und die angegebenen Strukturen.

Wert	Bedeutung
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

Ein Zeiger auf eine CERT_PUBLIC_KEY_INFO-Struktur , einen Zertifikatkontext, einen Kettenkontext oder NULL , abhängig vom Wert von dwSignerType.

Hinweise

Wenn dwSignerType CMSG_VERIFY_SIGNER_NULL ist, wird erwartet, dass die Signatur nur die unverschlüsselten Hash-Oktette enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincrypt.h

Share via