LZCopy, fonction (lzexpand.h)
Copie un fichier source dans un fichier de destination. Si le fichier source a été compressé par l’algorithme Lempel-Ziv, cette fonction crée un fichier de destination décompressé. Si le fichier source n’est pas compressé, cette fonction duplique le fichier d’origine.
Syntaxe
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
Paramètres
[in] hfSource
Handle du fichier source.
[in] hfDest
Handle du fichier de destination.
Valeur retournée
Si la fonction réussit, la valeur de retour spécifie la taille, en octets, du fichier de destination.
Si la fonction échoue, la valeur de retour est un code LZERROR_*. Ces codes ont des valeurs inférieures à zéro. Notez que LZCopy n’appelle ni SetLastError ni SetLastErrorEx ; par conséquent, son échec n’affecte pas le code de dernière erreur d’un thread.
Voici une liste de codes d’erreur que LZCopy 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 handle identifiant le fichier de destination n’est pas valide. Impossible d’écrire 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 format de fichier source n’est pas valide. |
Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.
Notes
Les handles identifiant les fichiers source et de destination doivent être récupérés en appelant la fonction LZInit ou LZOpenFile .
Si la fonction réussit, le fichier identifié par le paramètre hfDest est toujours décompressé.
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 |
Voir aussi
Compression et décompression de fichiers