PFN_CMSG_GEN_CONTENT_ENCRYPT_KEY Rückruffunktion (wincrypt.h)

Artikel
03/06/2024

Die PFN_CMSG_GEN_CONTENT_ENCRYPT_KEY Rückruffunktion generiert den symmetrischen Schlüssel, der zum Verschlüsseln von Inhalten für eine umhüllte Nachricht verwendet wird. Diese Funktion wird von der CryptMsgOpenToEncode-Funktion aufgerufen, wenn sie die CMSG_CONTENT_ENCRYPT_INFO-Struktur initialisiert.

Syntax

PFN_CMSG_GEN_CONTENT_ENCRYPT_KEY PfnCmsgGenContentEncryptKey;

BOOL PfnCmsgGenContentEncryptKey(
  [in, out] PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parameter

[in, out] pContentEncryptInfo

Ein Zeiger auf eine CMSG_CONTENT_ENCRYPT_INFO-Struktur , die den Schlüssel enthält.

[in] dwFlags

Dieser Wert wird nicht verwendet. Legen Sie ihn auf 0 (null) fest.

pvReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE). Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Sie können OID-Unterstützungsfunktionen verwenden, um diese Rückruffunktion bereitzustellen. Wincrypt.h definiert zu diesem Zweck die folgenden Konstanten.

Sie müssen verschiedene Rückruffunktionen für CAPI1-Schlüssel und Kryptografie-API definieren: CNG-Schlüssel (Next Generation). Beide Funktionen verfügen über die gleiche Signatur, verwenden jedoch unterschiedliche Objektbezeichner (OIDs). Welche Funktion aufgerufen wird, hängt vom Wert des fCNG-Elements der CMSG_CONTENT_ENCRYPT_INFO Struktur ab, auf die der pContentEncryptInfo-Parameter verweist. Die folgende Tabelle zeigt die Beziehung zwischen der Rückruffunktion und dem Wert des fCNG-Elements .

fCNG-Wert	Dauerhaft	Definition
FALSE	CMSG_OID_GEN_CONTENT_ENCRYPT_KEY_FUNC oder CMSG_OID_CAPI1_GEN_CONTENT_ENCRYPT_KEY_FUNC	"CryptMsgDllGenContentEncryptKey"
TRUE	CMSG_OID_CNG_GEN_CONTENT_ENCRYPT_KEY_FUNC	"CryptMsgDllCNGGenContentEncryptKey"

Anforderungen

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

Freigeben über