PFNCryptStreamOutputCallback 回呼函式 (ncryptprotect.h)
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 |
|---|---|
|
函式成功。 |
備註
在 NCRYPT_PROTECT_STREAM_INFO 結構的 pfnStreamOutput 成員中，設定這個回呼函式的指標。 在 NCryptStreamOpenToProtect 或 NCryptStreamOpenToUnprotect 函式的 pStreamInfo 參數中設定 結構的指標。
您可以使用此回呼進一步處理加密或解密的數據。 函式的常見用法是將數據寫入磁碟，因為從數據保護 API 接收數據。 NCryptStreamUpdate 函式會建立加密或未加密數據的區塊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | ncryptprotect.h |