|
|
|
|
|
|
|
|
|
|
- Condition d'utilisation
- Codes d'erreur
- Chemin mémorisé des fichiers de l'archive
- Archive auto-extractible
- Fermeture de l'archive
- Traduction de l'interface de l'auto-extracteur (paramètre )
- L'exécutable se situe sur un support duquel les fichiers archivés ne peuvent pas être extraits
- L'archive auto-extractible contient des fichiers exécutables
- Paramètres de la ligne de commande d'une archive auto-extractible
zipCréeExe (Fonction) En anglais : zipCreateExe Crée une archive auto-extractible sous forme d'un exécutable en 32 bits (.EXE). Lors du lancement de cet exécutable, les fichiers de l'archive sont automatiquement décompressés sur le poste en cours.
MonArchive est une zipArchive
ResOuvreArchive est un entier
ResExeArchive est un entier
ResOuvreArchive = zipOuvre(MonArchive, "D:\Sauvegardes\Sauvegarde.WDZ")
SI ResOuvreArchive = 0 ALORS
ResExeArchive = zipCréeExe(MonArchive, "C:\Répertoires\Archive.EXE")
...
FIN
Syntaxe
<Résultat> = zipCréeExe(<Archive> , <Chemin de l'exécutable> [, <Options d'extraction> [, <Icône de l'exécutable> [, <Répertoire d'extraction par défaut> [, <Traduction de l'auto-extraction>]]]])
<Résultat> : Entier - 0 si l'exécutable a été créé,
- Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.
<Archive> : Chaîne de caractères ou variable de type zipArchive Nom de l'archive à manipuler.
Ce nom peut correspondre :- soit au nom d'une archive défini avec la fonction zipOuvre ou la fonction zipCrée.
- soit au nom d'une variable de type zipArchive.
<Chemin de l'exécutable> : Chaîne de caractères Chemin de l'exécutable à créer (260 caractères maximum). Ce chemin peut être un chemin relatif au répertoire en cours ou un chemin complet.
L'extension .EXE est obligatoire. <Options d'extraction> : Constante optionnelle Options d'extraction à utiliser : | | | zipAdministrateur | Force l'exécutable créé à se lancer en tant qu'administrateur. Ce mode permet d'éviter la virtualisation des fichiers à partir de Windows Vista. | | zipArborescence | Les fichiers de l'archive seront extraits en respectant l'arborescence des répertoires contenus dans l'archive. | | zipAvecUI | L'auto-extraction affichera une boîte de dialogue permettant à l'utilisateur de choisir le répertoire de destination. | | zipChoixArborescence | L'auto-extraction affichera la case à cocher "Respecter l'arborescence" dans la boîte de dialogue. | | zipRepCourant | Tous les fichiers de l'archive seront extraits dans le répertoire en cours. | | zipRepDéfaut | Utilise le répertoire spécifié par défaut (paramètre <Répertoire d'extraction par défaut>). | zipRepTemporaire
(Valeur par défaut) | Les fichiers de l'archive seront extraits dans le répertoire temporaire de la machine sur laquelle l'exécutable est lancé. Tous les fichiers sont extraits au même endroit. |
<Icône de l'exécutable> : Chaîne de caractères optionnelle Chemin du fichier icône représentant l'exécutable créé. Ce chemin peut correspondre à un chemin relatif au chemin en cours ou à un chemin complet.
Si ce paramètre n'est pas précisé, une icône par défaut sera attribuée à l'exécutable. <Répertoire d'extraction par défaut> : Chaîne de caractères optionnelle Répertoire proposé par défaut par la fenêtre de décompression (si la constante zipAvecIHM est proposée). Si l'interface de l'extraction n'est pas proposée, ce répertoire sera utilisé par défaut pour extraire les fichiers de l'archive. <Traduction de l'auto-extraction> : Chaîne de caractères optionnelle Chemin complet du fichier au format INI contenant la traduction des messages de l'auto-extracteur. Le format de ce fichier est détaillé dans les Notes. Remarques Condition d'utilisation La création d'une archive auto-extractible peut être réalisée uniquement si : - L'archive existe (la création d'une archive s'effectue avec la fonction zipCrée).
- L'archive est accessible en lecture et en écriture.
- L'archive est mono-partie.
Attention : - Archives au format "CAB" : Cette fonction n'est pas disponible.
- Archives au format "RAR" : Cette fonction n'est pas disponible.
- Archives au format "7z" : Cette fonction n'est pas disponible.
- Archives au format "TAR" et "TARGZ" : Cette fonction n'est pas disponible.
Codes d'erreur Les codes d'erreur retournés sont les suivants : - 10 : Pas assez de place pour créer l'exécutable ou l'utilisateur n'a pas les droits en écriture sur l'archive originale (.WDZ).
- 11 : Erreur pendant la conversion de l'archive en archive auto-extractible.
- 12 : Pas assez de place pour créer l'exécutable, ou l'utilisateur n'a pas les droits en lecture sur l'archive originale (.WDZ).
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur. Chemin mémorisé des fichiers de l'archive Lors de l'extraction des fichiers d'une archive auto-extractible, le chemin mémorisé des fichiers n'est pas conservé. Seuls le nom et l'extension des fichiers sont conservés. Archive auto-extractible Une archive auto-extractible provenant d'une archive WINDEV peut être ouverte avec la fonction zipOuvre et manipulée comme toute autre archive. Il n'est pas possible de reconstruire l'archive originale (.WDZ ou .ZIP) à partir d'une archive auto-extractible. Il n'est pas possible de mettre de mot de passe sur une archive auto-extractible. Attention : - Une archive auto-extractible au format standard ZIP ne peut pas être ouverte avec la fonction zipOuvre.
- Si l'archive auto-extractible contient des sous-répertoires vides et non vides, lors de la décompression de l'archive, seuls les répertoires qui contiennent un fichier sont recréés.
Fermeture de l'archive Après utilisation de la fonction zipCréeExe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser la fonction zipFerme pour fermer l'archive originale. Traduction de l'interface de l'auto-extracteur (paramètre <Traduction de l'auto-extraction>) Par défaut, l'auto-extracteur est livré en trois langues : français, anglais et espagnol. La langue de l'auto-extracteur s'adapte en fonction de la langue de l'exécutable ou de la langue spécifiée par la fonction Nation. L'interface de l'auto-extracteur peut utiliser une langue différente de la langue par défaut (le français).
Pour cela, il suffit de créer un fichier .INI contenant les informations suivantes :
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Archive Autoextractible PC SOFT
R001=Extraire le contenu de l'archive dans le répertoire :
R002=Conserver l'arborescence
R003=Extraire
R004=Fermer Par exemple pour obtenir une interface en anglais :
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Self-Extracting PC SOFT archive
R001=Extract the content of the archive in the directory:
R002=Keep the tree structure
R003=Extract
R004=Close : Les trois premières lignes de ce fichier ne doivent pas être modifiées. Dans les lignes suivantes, indiquez la traduction voulue. Le paramètre <Traduction de l'auto-extraction> doit correspondre au chemin du fichier .INI contenant la traduction de l'interface. L'exécutable se situe sur un support duquel les fichiers archivés ne peuvent pas être extraits Il est possible que l'exécutable se situe sur un support (un CD par exemple) duquel les fichiers archivés ne peuvent pas être extraits. Il est alors nécessaire de lancer l'exécutable en précisant dans la ligne de commande :
Le paramètre <Répertoire> indique l'endroit duquel les fichiers archivés doivent être extraits. Si le paramètre <Répertoire> contient des espaces, il est nécessaire d'encadrer la chaîne de caractères par des guillemets. Ce paramètre est prioritaire sur le paramètre <Répertoire de l'extraction>. L'archive auto-extractible contient des fichiers exécutables Si le dernier fichier archivé est un fichier exécutable (.EXE), ce fichier sera lancé automatiquement après l'extraction de tous les fichiers de l'archive. Paramètres de la ligne de commande d'une archive auto-extractible Les paramètres suivants sont disponibles pour lancer une archive auto-extractible en ligne de commande : | | | /REP=<Répertoire> | Permet d'indiquer l'endroit duquel les fichiers archivés doivent être extraits. Si <Répertoire> contient des espaces, il est nécessaire d'encadrer la chaîne de caractères par des guillemets. Attention : Ce paramètre est prioritaire sur le paramètre <Répertoire de l'extraction> spécifié avec la fonction zipCréeExe. | | /TIT=<Titre> | <Titre> correspond au titre de la fenêtre d'auto-extraction. | | /PID=<Num PID> | Permet d'attendre la fin du processus <Num PID> avant de lancer l'extraction. | | /SILENT | Permet de lancer l'extraction sans jauge ni dialogue. | | /WAIT | Si l'archive auto-extractible lance un exécutable, l'amorce restera lancée aussi jusqu'à la fin de l'exécutable. | | /RELANCE | Extraction avec les droits d'administrateur. |
Composante : wd300zip.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|