LZInit, fonction (lzexpand.h)
Alloue de la mémoire pour les structures de données internes nécessaires à la décompression des fichiers, puis les crée et les initialise.
Syntaxe
INT LZInit(
[in] INT hfSource
);
Paramètres
[in] hfSource
Descripteur du fichier.
Valeur retournée
Si la fonction réussit, la valeur de retour est un nouveau handle de fichier LZ.
Si la fonction échoue, la valeur de retour est un code LZERROR_*. Ces codes ont des valeurs inférieures à zéro. Notez que LZInit n’appelle ni SetLastError ni SetLastErrorEx ; par conséquent, son échec n’affecte pas le code de dernière erreur d’un thread.
Voici la liste des codes d’erreur que LZInit peut retourner en cas d’échec.
| Code de retour | Description |
|---|---|
|
Le handle identifiant le fichier source n’est pas valide. Impossible de lire le fichier. |
|
Le nombre maximal de fichiers compressés ouverts a été dépassé ou la mémoire locale ne peut pas être allouée. |
|
Le handle de fichier LZ ne peut pas être verrouillé. |
|
Le fichier est compressé avec un algorithme de compression non reconnu. |
Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.
Notes
Un maximum de 16 fichiers compressés peuvent être ouverts à tout moment. De même, un maximum de 16 fichiers non compressés peuvent être ouverts à tout moment. Une application doit veiller à fermer le handle retourné par LZInit lorsqu’elle est effectuée à l’aide du fichier ; sinon, l’application peut atteindre par inadvertance la limite de 16 fichiers.
Le handle retourné par cette fonction n’est compatible qu’avec les fonctions dans Lz32.dll ; il ne doit pas être utilisé pour d’autres opérations de fichier.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Oui |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Oui |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
CsvFs effectue les E/S redirigées pour les fichiers compressés.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | lzexpand.h (inclure Windows.h) |
| Bibliothèque | Lz32.lib |
| DLL | Lz32.dll |