Função LZInit (lzexpand.h)

  • Artigo

Aloca memória para as estruturas de dados internos necessárias para descompactar arquivos e, em seguida, cria e inicializa-os.

Sintaxe

INT LZInit(
  [in] INT hfSource
);

Parâmetros

[in] hfSource

Um manipulador para o arquivo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um novo identificador de arquivo LZ.

Se a função falhar, o valor retornado será um código LZERROR_*. Esses códigos têm valores menores que zero. Observe que LZInit 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 dos códigos de erro que o LZInit 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_GLOBALLOC
 O número máximo de arquivos compactados abertos foi excedido ou a memória local não pode ser alocada.
LZERROR_GLOBLOCK
 O identificador de arquivo LZ não pode ser bloqueado.
LZERROR_UNKNOWNALG
 O arquivo é compactado com um algoritmo de compactação não reconhecido.
 

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

Comentários

No máximo 16 arquivos compactados podem ser abertos a qualquer momento. Da mesma forma, um máximo de 16 arquivos descompactados podem ser abertos a qualquer momento. Um aplicativo deve ter cuidado para fechar o identificador retornado por LZInit quando terminar de usar o arquivo; caso contrário, o aplicativo poderá atingir inadvertidamente o limite de 16 arquivos.

O identificador retornado por essa função é compatível apenas com as funções em Lz32.dll; ele não deve ser usado para outras operações de arquivo.

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

   
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