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) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |