PFN_CMSG_IMPORT_KEY_AGREE回呼函式 (wincrypt.h)

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

語法

PFN_CMSG_IMPORT_KEY_AGREE PfnCmsgImportKeyAgree;

BOOL PfnCmsgImportKeyAgree(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA pKeyAgreeDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

參數

[in] pContentEncryptionAlgorithm

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

[in] pKeyAgreeDecryptPara

包含金鑰合約收件者相關信息 之CMSG_CTRL_KEY_AGREE_DECRYPT_PARA 結構的指標。

[in] dwFlags

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

pvReserved

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

[out] phContentEncryptKey

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

傳回值

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

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

如果這個回呼函式不支援密鑰加密演算法，它必須傳回 FALSE，並使用 E_NOTIMPL 呼叫 SetLastError。

備註

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

常數	定義
CMSG_OID_IMPORT_KEY_AGREE_FUNC或CMSG_OID_CAPI1_IMPORT_KEY_AGREE_FUNC	“CryptMsgDllImportKeyAgree”

規格需求

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