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

另請參閱

BackupRead

BackupWrite

CreateFile