Функция 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 .
Дескриптор должен быть синхронным (без переключение). Это означает, что флаг 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 |