Função LZSeek (lzexpand.h)

  • Artigo

Move um ponteiro de arquivo o número especificado de bytes de uma posição inicial.

Sintaxe

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Parâmetros

[in] hFile

Um manipulador para o arquivo.

[in] lOffset

O número de bytes pelos quais mover o ponteiro do arquivo.

[in] iOrigin

A posição inicial do ponteiro. Esse parâmetro deve usar um dos valores a seguir.

Valor Significado
0
 Move o ponteiro de arquivo lOffset bytes do início do arquivo.
1
 Move o ponteiro de arquivo lOffset bytes da posição atual.
2
 Move o ponteiro de arquivo lOffset bytes do final do arquivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará o deslocamento do início do arquivo para a nova posição do ponteiro.

Se a função falhar, o valor retornado será um código LZERROR_*. Esses códigos têm valores inferiores a zero. Observe que LZSeek não chama SetLastError nem SetLastErrorEx; portanto, sua falha não afeta o código de último erro de um thread.

Veja a seguir a lista de códigos de erro que o LZSeek pode retornar após a falha.

Código de retorno Descrição
LZERROR_BADINHANDLE
 O identificador que identifica o arquivo de origem não é válido. O arquivo não pode ser lido.
LZERROR_BADVALUE
 Um dos parâmetros está fora do intervalo de valores aceitáveis.
LZERROR_GLOBLOCK
 O identificador de arquivo LZ não pode ser bloqueado.
 

Não há informações de erro estendidas para essa função; não chame GetLastError.

Comentários

O identificador identificado pelo parâmetro hFile deve ser recuperado chamando a função LZInit ou LZOpenFile .

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Sim
TFO (Failover transparente) do SMB 3.0 Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim
 

CsvFs fará E/S redirecionada em caso de arquivos compactados.

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 lzexpand.h (inclua Windows.h)
Biblioteca Lz32.lib
DLL Lz32.dll

Confira também

Descompactação e compactação de arquivo

Funções de gerenciamento de arquivos

LZInit

LZOpenFile