PFN_CMSG_IMPORT_MAIL_LIST Rückruffunktion (wincrypt.h)

Artikel
07/16/2024

Die PFN_CMSG_IMPORT_MAIL_LIST Rückruffunktion importiert einen Inhaltsverschlüsselungsschlüssel für einen Schlüsseltransportempfänger einer umschlägen Nachricht. PFN_CMSG_IMPORT_MAIL_LIST kann mithilfe einer CryptoAPI Objektbezeichnerinstalliert werden. Diese Funktion wird von der CryptMsgControl--Funktion aufgerufen, wenn der dwCtrlType Parameter auf CMSG_CTRL_DECRYPTfestgelegt ist.

Syntax

PFN_CMSG_IMPORT_MAIL_LIST PfnCmsgImportMailList;

BOOL PfnCmsgImportMailList(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_MAIL_LIST_DECRYPT_PARA pMailListDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parameter

[in] pContentEncryptionAlgorithm

Ein Zeiger auf eine CRYPT_ALGORITHM_IDENTIFIER Struktur, die den Algorithmus angibt, mit dem der Nachrichteninhalt und alle zugehörigen Parameter verschlüsselt werden.

[in] pMailListDecryptPara

Ein Zeiger auf eine CMSG_CTRL_MAIL_LIST_DECRYPT_PARA Struktur, die Informationen zum Empfänger der Adressenliste enthält.

[in] dwFlags

Dieser Wert wird nicht verwendet. Legen Sie sie auf Null fest.

pvReserved

Dieser Parameter ist reserviert und muss NULL-sein.

[out] phContentEncryptKey

Die Adresse eines Handles für den von dieser Funktion zurückgegebenen Inhaltsverschlüsselungsschlüssel.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null (FALSE). Rufen Sie für erweiterte Fehlerinformationen GetLastError-auf.

Wenn diese Rückruffunktion den Schlüsselverschlüsselungsalgorithmus nicht unterstützt, muss sie FALSE- zurückgeben und SetLastError- mit E_NOTIMPLaufrufen.

Bemerkungen

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

Konstante	Definition
CMSG_OID_IMPORT_MAIL_LIST_FUNC oder CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	"CryptMsgDllImportMailList"

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincrypt.h

Freigeben über