Fungsi BackupSeek (winbase.h)

Fungsi BackupSeek mencari ke depan dalam aliran data yang awalnya diakses dengan menggunakan fungsi BackupRead atau BackupWrite .

Sintaks

BOOL BackupSeek(
  [in]  HANDLE  hFile,
  [in]  DWORD   dwLowBytesToSeek,
  [in]  DWORD   dwHighBytesToSeek,
  [out] LPDWORD lpdwLowByteSeeked,
  [out] LPDWORD lpdwHighByteSeeked,
  [in]  LPVOID  *lpContext
);

Parameter

[in] hFile

Tangani ke file atau direktori. Handel ini dibuat dengan menggunakan fungsi CreateFile .

Handel harus sinkron (tidak tumpang tindih). Ini berarti bahwa bendera FILE_FLAG_OVERLAPPED tidak boleh diatur saat CreateFile dipanggil. Fungsi ini tidak memvalidasi bahwa handel yang diterimanya sinkron, sehingga tidak mengembalikan kode kesalahan untuk handel sinkron, tetapi memanggilnya dengan handel asinkron (tumpang tindih) dapat mengakibatkan kesalahan halus yang sangat sulit untuk di-debug.

[in] dwLowBytesToSeek

Bagian urutan rendah dari jumlah byte yang akan dicari.

[in] dwHighBytesToSeek

Bagian urutan tinggi dari jumlah byte yang akan dicari.

[out] lpdwLowByteSeeked

Penunjuk ke variabel yang menerima bit urutan rendah dari jumlah byte yang sebenarnya dicari oleh fungsi.

[out] lpdwHighByteSeeked

Penunjuk ke variabel yang menerima bit urutan tinggi dari jumlah byte yang sebenarnya dicari fungsi.

[in] lpContext

Penunjuk ke struktur data internal yang digunakan oleh fungsi . Struktur ini harus merupakan struktur yang sama yang diinisialisasi oleh fungsi BackupRead atau BackupWrite . Aplikasi tidak boleh menyentuh isi struktur ini.

Nilai kembali

Jika fungsi dapat mencari jumlah yang diminta, fungsi mengembalikan nilai bukan nol.

Jika fungsi tidak dapat mencari jumlah yang diminta, fungsi mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Aplikasi menggunakan fungsi BackupSeek untuk melewati bagian aliran data yang menyebabkan kesalahan. Fungsi ini tidak mencari di seluruh header stream. Misalnya, fungsi ini tidak dapat digunakan untuk melewati nama aliran. Jika aplikasi mencoba mencari melewati akhir substream, fungsi gagal, parameter lpdwLowByteSeeked dan lpdwHighByteSeeked menunjukkan jumlah byte aktual yang dicari fungsi, dan posisi file ditempatkan di awal header stream berikutnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

BackupRead

BackupWrite

CreateFile