PFE_EXPORT_FUNC回调函数 (winbase.h)

项目
03/03/2024

与 ReadEncryptedFileRaw 一起使用的应用程序定义回调函数。系统调用 ExportCallback 一次或多次，每次使用加密文件的数据块调用 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 失败而失败，则可以将返回值设置为 GetLastError 为失败的 API 返回的值。

注解

可以使用应用程序定义的上下文块对信息（例如文件句柄和文件中的当前偏移量）进行内部跟踪。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)