PFNCryptStreamOutputCallback 回呼函式 (ncryptprotect.h)

發行項
02/29/2024

PFNCryptStreamOutputCallback 函式會從使用 NCryptStreamOpenToProtect 或 NCryptStreamOpenToUnprotect 函式啟動的工作接收加密或解密的數據。此回呼必須由您的應用程式使用下列語法來定義。

語法

PFNCryptStreamOutputCallback Pfncryptstreamoutputcallback;

SECURITY_STATUS Pfncryptstreamoutputcallback(
  [in] void *pvCallbackCtxt,
  [in] const BYTE *pbData,
       SIZE_T cbData,
       BOOL fFinal
)
{...}

參數

[in] pvCallbackCtxt

可用來追蹤應用程式之數據的指標。數據保護 API 不會修改數據。

注意您可以在 NCryptStreamOpenToProtect 或 NCryptStreamOpenToUnprotect 函式的 pStreamInfo 參數中，先在 NCRYPT_PROTECT_STREAM_INFO 結構的 pvCallbackCtxt 成員中設定內容數據的指標。

[in] pbData

應用程式可以使用之已處理數據的區塊指標。

cbData

pbData 參數所指向之已處理數據的大小，以位元組為單位。

fFinal

如果此值為 TRUE，則目前的數據區塊是最後一個要處理的數據區塊，而這是上次呼叫回呼的時間。

傳回值

如果您從此回呼函式的實作傳回 ERROR_SUCCESS 以外的任何狀態代碼，數據流加密或解密程式將會失敗。

傳回碼	Description
ERROR_SUCCESS	函式成功。

備註

在 NCRYPT_PROTECT_STREAM_INFO 結構的 pfnStreamOutput 成員中，設定這個回呼函式的指標。在 NCryptStreamOpenToProtect 或 NCryptStreamOpenToUnprotect 函式的 pStreamInfo 參數中設定結構的指標。

您可以使用此回呼進一步處理加密或解密的數據。函式的常見用法是將數據寫入磁碟，因為從數據保護 API 接收數據。 NCryptStreamUpdate 函式會建立加密或未加密數據的區塊。

規格需求

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