LZOpenFileA, fonction (lzexpand.h)
Crée, ouvre, rouvert ou supprime le fichier spécifié.
Syntaxe
INT LZOpenFileA(
[in] LPSTR lpFileName,
[out] LPOFSTRUCT lpReOpenBuf,
[in] WORD wStyle
);
Paramètres
[in] lpFileName
Nom du fichier.
[out] lpReOpenBuf
Pointeur vers la structure OFSTRUCT
Le szPathName membre de cette structure contient des caractères du jeu de caractères oem (original equipment manufacturer).
[in] wStyle
Action à entreprendre. Ce paramètre peut être une ou plusieurs des valeurs suivantes.
Valeur de retour
Si la fonction réussit et que la valeur spécifiée par le paramètre wStyle n’est pas OF_READ, la valeur de retour est un handle identifiant le fichier. Si le fichier est compressé et ouvert avec wStyle défini sur OF_READ, la valeur de retour est un handle de fichier spécial.
Si la fonction échoue, la valeur de retour est un code LZERROR_*. Ces codes ont des valeurs inférieures à zéro. Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.
Retourner le code/la valeur | Description |
---|---|
|
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. |
Remarques
Si le paramètre wStyle
Le handle de cette fonction retourne est compatible uniquement avec les fonctions dans Lz32.dll; il ne doit pas être utilisé pour d’autres opérations de fichier.
Si LZOpenFile ne parvient pas à ouvrir le fichier spécifié par lpFileName, sur certaines versions de Windows, il tente d’ouvrir un fichier avec presque le même nom de fichier, sauf que le dernier caractère est remplacé par un trait de soulignement («»). Ainsi, si une tentative d’ouverture de «MyProgram.exe» échoue, LZOpenFile tente d’ouvrir « MyProgram.ex». Les packages d’installation remplacent souvent le trait de soulignement de la dernière lettre d’une extension de nom de fichier pour indiquer que le fichier est compressé. Par exemple, «MyProgram.exe» compressé peut être nommé « MyProgram.ex_ ». Pour déterminer le nom du fichier ouvert (le cas échéant), examinez le membre
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
Technologie | Supporté |
---|---|
Protocole SMB (Server Message Block) 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 |
Cluster Shared Volume File System (CsvFS) | Oui |
Système de fichiers résilient (ReFS) | Oui |
Les fichiers CSV effectuent des E/S redirigés pour les fichiers compressés.
Note
L’en-tête lzexpand.h définit LZOpenFile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows XP [applications de bureau uniquement] |
serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
plateforme cible | Windows |
d’en-tête | lzexpand.h (include Windows.h) |
bibliothèque | Lz32.lib |
DLL | Lz32.dll |
Voir aussi
compression et décompression de fichiers