BackupSeek 函数 (winbase.h)
BackupSeek 函数在最初使用 BackupRead 或 BackupWrite 函数访问的数据流中向前查找。
语法
BOOL BackupSeek(
[in] HANDLE hFile,
[in] DWORD dwLowBytesToSeek,
[in] DWORD dwHighBytesToSeek,
[out] LPDWORD lpdwLowByteSeeked,
[out] LPDWORD lpdwHighByteSeeked,
[in] LPVOID *lpContext
);
参数
[in] hFile
文件或目录的句柄。 此句柄是使用 CreateFile 函数创建的。
句柄必须是同步 (非重叠) 。 这意味着在调用 CreateFile 时，不得设置FILE_FLAG_OVERLAPPED标志。 此函数不会验证它收到的句柄是否同步，因此它不会返回同步句柄的错误代码，但使用异步 (重叠) 句柄调用它可能会导致非常难以调试的细微错误。
[in] dwLowBytesToSeek
要查找的字节数的低序部分。
[in] dwHighBytesToSeek
要查找的字节数的高序部分。
[out] lpdwLowByteSeeked
指向变量的指针，该变量接收函数实际查找的字节数的低序位。
[out] lpdwHighByteSeeked
指向变量的指针，该变量接收函数实际查找的字节数的高阶位。
[in] lpContext
指向函数使用的内部数据结构的指针。 此结构必须与 BackupRead 或 BackupWrite 函数初始化的结构相同。 应用程序不得接触此结构的内容。
返回值
如果函数可以查找请求的量，则函数将返回非零值。
如果函数无法查找请求的量，则函数返回零。 要获得更多的错误信息，请调用 GetLastError。
注解
应用程序使用 BackupSeek 函数跳过导致错误的数据流部分。 此函数不会跨流标头查找。 例如，此函数不能用于跳过流名称。 如果应用程序尝试在子流的末尾进行查找，则函数将失败， lpdwLowByteSeeked 和 lpdwHighByteSeeked 参数指示函数查找的实际字节数，并且文件位置将放置在下一个流标头的开头。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winbase.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |