Función BackupSeek (winbase.h)

  • Artículo

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

Vea también

BackupRead

BackupWrite

CreateFile