PFN_CMSG_IMPORT_MAIL_LIST Rückruffunktion (wincrypt.h)

Die PFN_CMSG_IMPORT_MAIL_LIST Rückruffunktion importiert einen Inhaltsverschlüsselungsschlüssel für einen Schlüsseltransportempfänger einer umhüllten Nachricht. PFN_CMSG_IMPORT_MAIL_LIST können mithilfe eines CryptoAPI-Objektbezeichners installiert werden. Diese Funktion wird von der CryptMsgControl-Funktion aufgerufen, wenn ihr dwCtrlType-Parameter auf CMSG_CTRL_DECRYPT festgelegt 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, der zum Verschlüsseln des Nachrichteninhalts und aller zugeordneten Parameter verwendet wird.

[in] pMailListDecryptPara

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

[in] dwFlags

Dieser Wert wird nicht verwendet. Legen Sie sie auf 0 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 nonzero (TRUE).

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

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

Hinweise

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_IMPORT_MAIL_LIST_FUNC oder CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	"CryptMsgDllImportMailList"

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