PFN_CMSG_EXPORT_MAIL_LIST Rückruffunktion (wincrypt.h)

Artikel
03/06/2024

Die PFN_CMSG_EXPORT_MAIL_LIST Rückruffunktion verschlüsselt und exportiert den Inhaltsverschlüsselungsschlüssel für einen Empfänger der Adressliste einer umhüllten Nachricht. PFN_CMSG_EXPORT_MAIL_LIST können mithilfe eines CryptoAPI-Objektbezeichners (OID) installiert werden. Diese Funktion wird von der CryptMsgOpenToEncode-Funktion aufgerufen, wenn ihr dwMsgType-Parameter auf CMSG_ENVELOPED festgelegt ist.

Syntax

PFN_CMSG_EXPORT_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parameter

[in] pContentEncryptInfo

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

[in] pMailListEncodeInfo

Ein Zeiger auf eine CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO-Struktur , die den Schlüssel angibt, der zum Verschlüsseln des Inhaltsverschlüsselungsschlüssels verwendet wird.

[in, out] pMailListEncryptInfo

Ein Zeiger auf eine CMSG_MAIL_LIST_ENCRYPT_INFO-Struktur , die den Verschlüsselungsschlüssel für verschlüsselten Inhalt 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

Die funktion PFN_CMSG_EXPORT_MAIL_LIST muss das EncryptedKey-Element der CMSG_MAIL_LIST_ENCRYPT_INFO-Struktur aktualisieren, auf die der pMailListEncryptInfo-Parameter verweist. Diese Funktion muss die Elemente pfnAlloc und pfnFree der CMSG_CONTENT_ENCRYPT_INFO Struktur verwenden, auf die der pContentEncryptInfo-Parameter verweist, um den Arbeitsspeicher für alle Werte zu verwalten, die aktualisiert werden.

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

Dauerhaft	Definition
CMSG_OID_EXPORT_MAIL_LIST_FUNC oder CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	"CryptMsgDllExportMailList"

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

Share via