PFN_CMSG_IMPORT_MAIL_LIST回呼函式 （wincrypt.h）

PFN_CMSG_IMPORT_MAIL_LIST 回呼函式會匯入封封郵件之金鑰傳輸收件者的內容加密金鑰。 您可以使用 CryptoAPI物件識別碼來安裝 PFN_CMSG_IMPORT_MAIL_LIST。 當 dwCtrlType 參數設為 CMSG_CTRL_DECRYPT時，CryptMsgControl 函式會呼叫此函式。

語法

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

參數

[in] pContentEncryptionAlgorithm

CRYPT_ALGORITHM_IDENTIFIER 結構的指標，指定用來加密訊息內容和任何相關聯參數的演算法。

[in] pMailListDecryptPara

包含郵件清單收件者相關信息之 CMSG_CTRL_MAIL_LIST_DECRYPT_PARA 結構的指標。

[in] dwFlags

未使用此值。 將它設定為零。

pvReserved

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

[out] phContentEncryptKey

此函式所傳回之內容加密金鑰的句柄位址。

傳回值

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

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

如果此回呼函式不支援密鑰加密演算法，則必須傳回 false ，並使用 E_NOTIMPL呼叫 SetLastError。

言論

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

不斷	定義
CMSG_OID_IMPORT_MAIL_LIST_FUNC或CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	“CryptMsgDllImportMailList”

要求

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