PFE_EXPORT_FUNC回调函数 (winbase.h)

与 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)

另请参阅

CloseEncryptedFileRaw

文件加密

文件管理函数

ImportCallback

OpenEncryptedFileRaw

ReadEncryptedFileRaw

WriteEncryptedFileRaw