CMSG_CTRL_DECRYPT_PARA-Struktur (wincrypt.h)

Die CMSG_CTRL_DECRYPT_PARA-Struktur enthält Informationen, die zum Entschlüsseln einer umhüllten Nachricht für einen Schlüsseltransportempfänger verwendet werden. Diese Struktur wird an CryptMsgControl übergeben, wenn der dwCtrlType-Parameter CMSG_CTRL_DECRYPT ist.

Informationen dazu, wie CryptoAPI die Interoperabilität von Secure/Multipurpose Internet Mail Extensions (S/MIME) unterstützt, finden Sie im Abschnitt Hinweise von CryptMsgOpenToEncode.

Syntax

typedef struct _CMSG_CTRL_DECRYPT_PARA {
  DWORD cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD dwKeySpec;
  DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA, *PCMSG_CTRL_DECRYPT_PARA;

Member

cbSize

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

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Handle des Kryptografiedienstanbieters (Cryptographic Service Provider , CSP). Die CNG-Funktion NCryptIsKeyHandle wird aufgerufen, um die Union-Auswahl zu bestimmen.

DUMMYUNIONNAME.hNCryptKey

Ein Handle für den CNG-Kryptografiedienstanbieter (CSP). Die CNG-Funktion NCryptIsKeyHandle wird aufgerufen, um die Union-Auswahl zu bestimmen. Neue Verschlüsselungsalgorithmen werden nur in CNG-Funktionen unterstützt. Die CNG-Funktion NCryptTranslateHandle wird aufgerufen, um die Wahl CryptoAPI hCryptProv zu konvertieren, falls erforderlich. Es wird empfohlen, dass Anwendungen das CNG-CSP-Handle, das von der NCryptOpenKey-Funktion zurückgegeben wird, an das hNCryptKey-Element übergeben.

dwKeySpec

Der zu verwendende private Schlüssel. Dieses Element wird nicht verwendet, wenn das hNCryptKey-Element verwendet wird.

Die folgenden dwKeySpec-Werte sind für den Standardanbieter definiert.

Wert	Bedeutung
AT_KEYEXCHANGE	Schlüssel, die zum Verschlüsseln und Entschlüsseln von Sitzungsschlüsseln verwendet werden.
AT_SIGNATURE	Schlüssel, die zum Erstellen und Überprüfen digitaler Signaturen verwendet werden.

 

Wenn dwKeySpec null ist, wird die Standard-AT_KEYEXCHANGE verwendet.

dwRecipientIndex

Index des Empfängers in der Nachricht, die dem privaten Schlüssel hCryptProv zugeordnet ist.

Anforderungen

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

Weitere Informationen

CryptMsgControl