Função BackupSeek (winbase.h)

  • Artigo

A função BackupSeek busca encaminhar em um fluxo de dados inicialmente acessado usando a função BackupRead ou BackupWrite .

Sintaxe

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

Parâmetros

[in] hFile

Manipule para o arquivo ou diretório. Esse identificador é criado usando a função CreateFile .

O identificador deve ser síncrono (não sobreposto). Isso significa que o sinalizador FILE_FLAG_OVERLAPPED não deve ser definido quando CreateFile é chamado. Essa função não valida se o identificador que recebe é síncrono, portanto, não retorna um código de erro para um identificador síncrono, mas chamá-lo com um identificador assíncrono (sobreposto) pode resultar em erros sutis que são muito difíceis de depurar.

[in] dwLowBytesToSeek

Parte de baixa ordem do número de bytes a serem buscados.

[in] dwHighBytesToSeek

Parte de alta ordem do número de bytes a serem buscados.

[out] lpdwLowByteSeeked

Ponteiro para uma variável que recebe os bits de baixa ordem do número de bytes que a função realmente busca.

[out] lpdwHighByteSeeked

Ponteiro para uma variável que recebe os bits de alta ordem do número de bytes que a função realmente busca.

[in] lpContext

Ponteiro para uma estrutura de dados interna usada pela função . Essa estrutura deve ser a mesma estrutura que foi inicializada pela função BackupRead ou BackupWrite . Um aplicativo não deve tocar no conteúdo dessa estrutura.

Retornar valor

Se a função puder buscar o valor solicitado, a função retornará um valor diferente de zero.

Se a função não puder buscar o valor solicitado, a função retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os aplicativos usam a função BackupSeek para ignorar partes de um fluxo de dados que causam erros. Essa função não busca cabeçalhos de fluxo. Por exemplo, essa função não pode ser usada para ignorar o nome do fluxo. Se um aplicativo tentar buscar além do final de um substream, a função falhará, os parâmetros lpdwLowByteSeeked e lpdwHighByteSeeked indicarão o número real de bytes que a função busca e a posição do arquivo será colocada no início do próximo cabeçalho de fluxo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

BackupRead

BackupWrite

CreateFile