Função BackupSeek (winbase.h)
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 |