Função LZInit (lzexpand.h)
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 |
|---|---|
|
O identificador que identifica o arquivo de origem não é válido. O arquivo não pode ser lido. |
|
O número máximo de arquivos compactados abertos foi excedido ou a memória local não pode ser alocada. |
|
O identificador de arquivo LZ não pode ser bloqueado. |
|
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 |