Freigeben über


CRYPT_KEY_SIGN_MESSAGE_PARA-Struktur (wincrypt.h)

Die CRYPT_KEY_SIGN_MESSAGE_PARA-Struktur enthält Informationen zum Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) und algorithmen, die zum Signieren einer Nachricht verwendet werden.

Syntax

typedef struct _CRYPT_KEY_SIGN_MESSAGE_PARA {
  DWORD                      cbSize;
  DWORD                      dwMsgAndCertEncodingType;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD                      dwKeySpec;
  CRYPT_ALGORITHM_IDENTIFIER HashAlgorithm;
  void                       *pvHashAuxInfo;
  CRYPT_ALGORITHM_IDENTIFIER PubKeyAlgorithm;
} CRYPT_KEY_SIGN_MESSAGE_PARA, *PCRYPT_KEY_SIGN_MESSAGE_PARA;

Member

cbSize

Die Größe dieser Datenstruktur in Bytes.

dwMsgAndCertEncodingType

Gibt den Typ der verwendeten Nachrichten- und Zertifikatcodierung an. Dies kann eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert Bedeutung
X509_ASN_ENCODING
Gibt die X.509-Zertifikatcodierung an.
PKCS_7_ASN_ENCODING
Gibt die PKCS 7-Nachrichtencodierung an.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Das Handle des CSP, der zum Signieren der Nachricht verwendet werden soll. Die CryptAcquireContext-Funktion wird aufgerufen, um dieses Handle abzurufen.

DUMMYUNIONNAME.hNCryptKey

Das Handle des CNG-CSP (Cryptography API: Next Generation) zum Signieren der Nachricht. CNG-Signaturalgorithmen werden nur in CNG-Funktionen unterstützt.

dwKeySpec

Gibt den Typ des privaten Schlüssels an, der zum Signieren der Nachricht verwendet werden soll. Dies muss einer der folgenden Werte sein. Dieser Member wird ignoriert, wenn ein CNG-Schlüssel im hNCryptKey-Member übergeben wird.

Wert Bedeutung
AT_KEYEXCHANGE
Verwenden Sie den Schlüsselaustauschschlüssel.
AT_SIGNATURE
Verwenden Sie den Schlüssel für die digitale Signatur.

HashAlgorithm

Eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Algorithmus angibt, der zum Generieren des Hashs der Nachricht verwendet werden soll. Dies muss ein Hashalgorithmus sein.

pvHashAuxInfo

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

PubKeyAlgorithm

Eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Algorithmus angibt, der zum Signieren der Nachricht verwendet werden soll. Dies muss entweder ein öffentlicher Schlüssel oder ein Signaturalgorithmus sein.

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