Функция BackupSeek (winbase.h)

Статья
08/27/2023

Функция 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 .

Дескриптор должен быть синхронным (без переключение). Это означает, что флаг FILE_FLAG_OVERLAPPED не должен устанавливаться при вызове CreateFile . Эта функция не проверяет, является ли получаемый дескриптор синхронным, поэтому она не возвращает код ошибки для синхронного дескриптора, но вызов его с асинхронным (перекрывающимся) дескриптором может привести к незначительным ошибкам, которые очень трудно отлаживать.

[in] dwLowBytesToSeek

Низкая часть числа байтов для поиска.

[in] dwHighBytesToSeek

Высокий порядок от количества байтов для поиска.

[out] lpdwLowByteSeeked

Указатель на переменную, которая получает биты низкого порядка от количества байтов, которые фактически ищет функция.

[out] lpdwHighByteSeeked

Указатель на переменную, которая получает биты высокого порядка от количества байтов, которые фактически ищет функция.

[in] lpContext

Указатель на внутреннюю структуру данных, используемую функцией . Эта структура должна быть той же структурой, которая была инициализирована функцией BackupRead или BackupWrite . Приложение не должно касаться содержимого этой структуры.

Возвращаемое значение

Если функция может искать запрошенную сумму, функция возвращает ненулевое значение.

Если функции не удалось найти запрошенную сумму, функция возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Приложения используют функцию BackupSeek для пропуска частей потока данных, которые вызывают ошибки. Эта функция не выполняет поиск по заголовкам потока. Например, эту функцию нельзя использовать для пропуска имени потока. Если приложение пытается выполнить поиск после конца подпотока, функция завершается сбоем, параметры lpdwLowByteSeeked и lpdwHighByteSeeked указывают фактическое количество байтов, которые ищет функция, и позиция файла помещается в начало заголовка следующего потока.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

BackupRead

BackupWrite

CreateFile