Función BackupSeek (winbase.h)
La función BackupSeek busca hacia delante en un flujo de datos al que se accede inicialmente mediante la función BackupRead o BackupWrite .
Sintaxis
BOOL BackupSeek(
[in] HANDLE hFile,
[in] DWORD dwLowBytesToSeek,
[in] DWORD dwHighBytesToSeek,
[out] LPDWORD lpdwLowByteSeeked,
[out] LPDWORD lpdwHighByteSeeked,
[in] LPVOID *lpContext
);
Parámetros
[in] hFile
Identificador del archivo o directorio. Este identificador se crea mediante la función CreateFile .
El identificador debe ser sincrónico (no superpuesto). Esto significa que la marca FILE_FLAG_OVERLAPPED no debe establecerse cuando se llama a CreateFile . Esta función no valida que el identificador que recibe sea sincrónico, por lo que no devuelve un código de error para un identificador sincrónico, pero llamarlo con un identificador asincrónico (superpuesto) puede dar lugar a errores sutiles que son muy difíciles de depurar.
[in] dwLowBytesToSeek
Parte de orden bajo del número de bytes que se van a buscar.
[in] dwHighBytesToSeek
Parte de orden superior del número de bytes que se van a buscar.
[out] lpdwLowByteSeeked
Puntero a una variable que recibe los bits de orden inferior del número de bytes que realmente busca la función.
[out] lpdwHighByteSeeked
Puntero a una variable que recibe los bits de orden superior del número de bytes que realmente busca la función.
[in] lpContext
Puntero a una estructura de datos interna usada por la función . Esta estructura debe ser la misma estructura inicializada por la función BackupRead o BackupWrite . Una aplicación no debe tocar el contenido de esta estructura.
Valor devuelto
Si la función podría buscar la cantidad solicitada, la función devuelve un valor distinto de cero.
Si la función no pudo buscar la cantidad solicitada, la función devuelve cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Las aplicaciones usan la función BackupSeek para omitir partes de un flujo de datos que provocan errores. Esta función no busca entre encabezados de secuencia. Por ejemplo, esta función no se puede usar para omitir el nombre de la secuencia. Si una aplicación intenta buscar más allá del final de una substream, se produce un error en la función, los parámetros lpdwLowByteSeeked y lpdwHighByteSeeked indican el número real de bytes que busca la función y la posición del archivo se coloca al principio del siguiente encabezado de secuencia.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |