PFN_CMSG_EXPORT_MAIL_LIST回呼函式 (wincrypt.h)

PFN_CMSG_EXPORT_MAIL_LIST回呼函式會加密並匯出信封郵件的郵件清單收件者的內容加密密鑰。 PFN_CMSG_EXPORT_MAIL_LIST 可以使用 CryptoAPI物件識別碼 (OID) 來安裝。 當其 dwMsgType 參數設定為 CMSG_ENVELOPED時，CryptMsgOpenToEncode 函式會呼叫此函式。

語法

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
)
{...}

參數

[in] pContentEncryptInfo

包含內容加密金鑰 之CMSG_CONTENT_ENCRYPT_INFO 結構的指標。

[in] pMailListEncodeInfo

CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO 結構的指標，指定用來加密內容加密密鑰的金鑰。

[in, out] pMailListEncryptInfo

包含加密內容加密金鑰 之CMSG_MAIL_LIST_ENCRYPT_INFO 結構的指標。

[in] dwFlags

不使用這個值。 將它設定為零。

pvReserved

此參數是保留的，而且必須是 NULL。

傳回值

如果函式成功，則傳回值為非零 (TRUE) 。

如果函式失敗，則傳回值為零， (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。

備註

PFN_CMSG_EXPORT_MAIL_LIST函式必須更新 pMailListEncryptInfo 參數所指向之CMSG_MAIL_LIST_ENCRYPT_INFO結構的 EncryptedKey 成員。 此函式必須使用 pContentEncryptInfo 參數所指向之CMSG_CONTENT_ENCRYPT_INFO結構的 pfnAlloc 和 pfnFree 成員，以管理其更新之任何值的記憶體。

您可以使用 OID 支援函式 來部署此回呼函式。 Wincrypt.h 會為此目的定義下列常數。

常數	定義
CMSG_OID_EXPORT_MAIL_LIST_FUNC或CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	“CryptMsgDllExportMailList”

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	wincrypt.h