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