共用方式為


PFE_EXPORT_FUNC回呼函式 (winbase.h)

搭配 ReadEncryptedFileRaw 使用的應用程式定義回調函式。 系統會呼叫 ExportCallback 一或多次,每次使用加密檔案數據的區塊,直到收到所有檔案數據為止。 ExportCallback 會將加密檔案的數據寫入另一個儲存媒體,通常是為了備份檔案。

PFE_EXPORT_FUNC類型會定義回呼函式的指標。 ExportCallback 是應用程式定義函數名稱的佔位元。

語法

PFE_EXPORT_FUNC PfeExportFunc;

DWORD PfeExportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in]           ULONG ulLength
)
{...}

參數

[in] pbData

要備份之加密檔案數據的區塊指標。 系統會配置此數據區塊。

[in, optional] pvCallbackContext

應用程式定義和已配置之內容區塊的指標。 應用程式會將此指標傳遞至 ReadEncryptedFileRaw,而 ReadEncryptedFileRaw 會將此指標傳遞至回調函式,讓它可以存取應用程式特定的數據。 此數據可以是結構,而且可以包含應用程式所需的任何數據,例如包含加密檔案備份複本之檔案的句柄。

[in] ulLength

pbData 參數所指向的數據大小,以位元組為單位。

傳回值

如果函式成功,則必須將傳回值設定為 ERROR_SUCCESS

如果函式失敗,請將傳回值設定為 WinError.h 中定義的非零錯誤碼。 例如,如果此函式因為呼叫的 API 失敗而失敗,您可以將傳回值設定為 失敗 API 的 GetLastError 所傳回的值。

備註

您可以使用應用程式定義的內容區塊來內部追蹤資訊,例如檔句柄和檔案中的目前位移。

規格需求

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

另請參閱

CloseEncryptedFileRaw

檔案加密

檔案管理功能

ImportCallback

OpenEncryptedFileRaw

ReadEncryptedFileRaw

WriteEncryptedFileRaw