AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos
  • Condiciones de uso
  • Códigos de error
  • Ruta almacenada de los archivos del archivo comprimido
  • Archivo comprimido autoextraíble
  • Cerrar el archivo
  • Traducción de la interfaz de la herramienta de autoextracción (parámetro )
  • El archivo ejecutable se encuentra en un medio del que no se pueden extraer los archivos
  • El archivo comprimido autoextraíble contiene archivos ejecutables
  • Parámetros de la línea de comandos de un archivo autoextraíble
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Crea un archivo comprimido autoextraíble (archivo .exe). Al abrir el archivo ejecutable, los archivos se extraen automáticamente en el equipo actual.
New in SaaS
Nota: Puede crear un archivo ejecutable autoextraíble de 64 bits.
Nota: Esta función solo está disponible a partir de WINDEV Suite SaaS 2025 - Update 3.
Para obtener más información, consulte Utilizar las novedades exclusivas de WINDEV Suite SaaS 2025.
Ejemplo
// Declare the variables
MyArchive is zipArchive
// Open the archive "MyArchive"
ResOpenArchive = MyArchive.Open("D:\Backups\Backup.WDZ")
IF ResOpenArchive = 0 THEN
	// Create a self-extracting archive
	ResArchiveExe = MyArchive.CreateExe("C:\Directories\Archive.EXE")
	...
END
New in SaaS
// Archive to be transformed into a self-extracting archive
Archive is zipArchive
// Open the archive
IF MyArchive.Open("D:\Backups\Backup.zip") = 0 THEN
	// Self-extracting archive creation parameters
	ParamExe is zipExeCreationParameter
	ParamExe.ExeFilePath = "C:\Directories\Archive.exe"
	ParamExe.DirectoryOption = zipCurrentDirectory
	ParamExe.Icon = "Icon.ico"
	// Create a self-extracting archive
	MyArchive.CreateExe(ParamExe)
	...
END
Sintaxis

Crear un archivo ejecutable autoextraíble especificando todos los parámetros Ocultar los detalles

<Result> = <Archive>.CreateExe(<Executable path> [, <Options> [, <Executable icon> [, <Default extraction directory> [, <Self-extractor translation> [, <Version number>]]]]])
<Result>: Entero
  • 0 si se creó el archivo ejecutable,
  • Un código de error (valor superior a 0) en caso contrario. Para obtener más información sobre los códigos de error, consulte las Observaciones.
<Archive>: Variable de tipo zipArchive
Nombre de una variable de tipo zipArchive que corresponde al archivo comprimido que se va a manipular.
<Executable path>: Cadena de caracteres
Ruta del archivo ejecutable que se va a crear (hasta 260 caracteres). Esta ruta puede ser una ruta relativa al directorio actual o una ruta completa.
La extensión .EXE es obligatoria.
<Options>: Constante opcional
Opciones de creación y extracción de ejecutables:
zipAdministratorHace que el archivo ejecutable creado se ejecute como administrador. Este modo evita la virtualización de archivos de Windows Vista.
zipCurrentDirectoryTodos los archivos se extraen en el directorio actual.
zipDefaultDirUtiliza el directorio predeterminado (parámetro <Default extraction directory>).
New in SaaS
zipExe64
Crea un archivo ejecutable de 64 bits. Si no se especifica esta constante, se creará un archivo ejecutable de 32 bits.
Nota: Esta función solo está disponible a partir de WINDEV Suite SaaS 2025 - Update 3.
Para obtener más información, consulte Utilizar las novedades exclusivas de WINDEV Suite SaaS 2025.
zipSelectRestorePathEn el cuadro de diálogo de extracción aparecerá la opción "Conservar la estructura".
zipTempDirectory
(Valor predeterminado)
Los archivos se extraen en el directorio temporal del equipo en el que se ejecuta el archivo ejecutable. Todos los archivos se extraen en la misma ubicación.
zipTreeLos archivos se extraerán conservando la estructura de los directorios del archivo.
zipWithUILa herramienta de autoextracción mostrará un cuadro de diálogo que permitirá a los usuarios elegir el directorio de destino.
<Executable icon>: Cadena de caracteres opcional
Ruta del archivo del ícono que representa el archivo ejecutable creado. Esta ruta puede corresponder a una ruta relativa a la ruta actual o a una ruta completa.
Si no se especifica este parámetro, se utilizará un ícono predeterminado para el archivo ejecutable.
<Default extraction directory>: Cadena de caracteres opcional
Directorio sugerido de forma predeterminada en la ventana de extracción (si se utiliza la constante zipWithUI). Si no se abre la ventana de extracción, este directorio se utilizará de forma predeterminada para extraer los archivos del archivo comprimido.
<Self-extractor translation>: Cadena de caracteres opcional
Ruta completa del archivo INI que contiene las traducciones de la herramienta de autoextracción. Los detalles del formato del archivo se presentan en las Observaciones.
Si este parámetro no se especifica o es una cadena vacía (""), se utilizará el archivo de traducción predeterminado.
<Version number>: Cadena de caracteres opcional
New in SaaS
Número de versión del nuevo archivo ejecutable. Este número debe tener el siguiente formato:
<Major version>.<Minor version>.<Compilation number>.<Revision number>
Por ejemplo "30.12.15.3".
Este número de versión puede obtenerse utilizando la función ExeInfo con la constante exeVersionWindowsFormat.
Si no se especifica este parámetro, se definirá un número de versión predeterminado basado en la versión utilizada para crear el archivo autoextraíble.
Nota: Esta funcionalidad solo está disponible a partir de WINDEV Suite SaaS 2025 - Update 2. Para obtener más información, consulte Utilizar las novedades exclusivas de WINDEV Suite SaaS 2025.
New in SaaS

Crear un archivo ejecutable autoextraíble especificando los parámetros mediante una variable de tipo zipExeCreationParameter Ocultar los detalles

<Result> = <Archive>.zipCreateExe(<Parameters>)
<Result>: Entero
  • 0 si se creó el archivo ejecutable,
  • Un código de error (valor superior a 0) en caso contrario. Para obtener más información sobre los códigos de error, consulte las Observaciones.
<Archive>: Variable de tipo zipArchive
Nombre de una variable de tipo zipArchive que corresponde al archivo comprimido que se va a manipular.
<Parameters>: Variable de tipo zipExeCreationParameter
Nombre de la variable de tipo zipExeCreationParameter que corresponde a los diferentes parámetros del archivo que se va a crear.
Observaciones

Condiciones de uso

Un archivo comprimido autoextraíble solo puede crearse si:
  • El archivo comprimido existe (los archivos comprimidos pueden crearse utilizando la función <zipArchive variable>.Create).
  • El archivo es accesible en modo de lectura/escritura.
  • El archivo es de una sola parte.
Atención:
  • Archivos CAB: Esta función no está disponible.
  • Archivos RAR: Esta función no está disponible.
  • Archivos 7z: Esta función no está disponible.
  • Archivos TAR y TARGZ: Esta función no está disponible.

Códigos de error

Los códigos de error devueltos son los siguientes:
  • 10: No hay espacio suficiente para crear el archivo ejecutable, o el usuario no tiene acceso de escritura al archivo de origen (.WDZ).
  • 11: Error al convertir el archivo en un archivo autoextraíble
  • 12: No hay espacio suficiente para crear el archivo ejecutable, o el usuario no tiene acceso de lectura al archivo de origen (.WDZ).
La función zipMsgError devuelve el mensaje que corresponde al código de error.

Ruta almacenada de los archivos del archivo comprimido

Cuando los archivos se extraen de un archivo autoextraíble, la ruta almacenada de los archivos no se conserva. Solo se almacenan el nombre y la extensión de los archivos.

Archivo comprimido autoextraíble

Un archivo autoextraíble de un archivo WINDEV puede abrirse con la función <zipArchive variable>Abrir y utilizarse como cualquier otro archivo.
El archivo de origen (.WDZ o .ZIP) no puede reconstruirse a partir de un archivo autoextraíble.
No se puede definir una contraseña para un archivo autoextraíble.
Atención:
  • Un archivo ZIP autoextraíble no puede abrirse con la función <zipArchive variable>Abrir.
  • Si el archivo autoextraíble contiene subdirectorios vacíos y no vacíos, al descomprimir el archivo sólo se vuelven a crear los directorios que contienen archivos.

Cerrar el archivo

Al utilizar la función <zipArchive variable>.CreateExe en un archivo comprimido, el archivo no se cierra. Debe llamar a la función <zipArchive variable>Cerrar para cerrar el archivo de origen.

Traducción de la interfaz de la herramienta de autoextracción (parámetro <Self-extractor translation>)

De forma predeterminada, la herramienta de autoextracción está disponible en tres idiomas: inglés, español y francés. La herramienta de autoextracción utilizará el idioma del archivo ejecutable o el idioma especificado con la función Nation.
La interfaz de la herramienta de autoextracción puede utilizar un idioma diferente del idioma predeterminado (inglés).
Interfaz de la herramienta de autoextracción
Para ello, cree un archivo .INI que contenga la siguiente información:
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Self-extracting PC SOFT archive
R001=Extract the content of the archive in the directory:
R002=Preserve tree structure
R003=Extract
R004=Close
Por ejemplo, para obtener una interfaz en francés:
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Archive Autoextractible PC SOFT
R001=Extraire le contenu de l'archive dans le repertoire:
R002=Conserver l'arborescence
R003=Extraire
R004=Fermer
Atención: Las tres primeras líneas de este archivo no deben modificarse.
En las líneas siguientes, especifique la traducción deseada.
El parámetro <Self-extractor translation> debe corresponder a la ruta del archivo .INI que contiene la traducción de la interfaz.

El archivo ejecutable se encuentra en un medio del que no se pueden extraer los archivos

Es posible que el archivo ejecutable esté ubicado en un medio (por ejemplo, un CD) del que no se pueden extraer los archivos. En este caso, ejecute el archivo ejecutable y especifique la siguiente línea de comandos:
/DIR=<Directory>
El parámetro <Directory> especifica la ubicación de la que deben extraerse los archivos. Si el parámetro <Directory> contiene espacios, la cadena de caracteres debe ir entre comillas.
Este parámetro tiene prioridad sobre el parámetro <Extraction directory>.

El archivo comprimido autoextraíble contiene archivos ejecutables

Si el último archivo comprimido es un archivo ejecutable (.EXE), este archivo se ejecutará automáticamente una vez que se hayan extraído todos los archivos.

Parámetros de la línea de comandos de un archivo autoextraíble

Los siguientes parámetros permiten ejecutar un archivo autoextraíble desde la línea de comandos:
/DIR=<Directory>Especifica la ubicación de la que deben extraerse los archivos comprimidos. Si el parámetro <Directory> contiene espacios, la cadena de caracteres debe ir entre comillas.
Atención: Este parámetro tiene prioridad sobre el parámetro <Extraction directory> especificado con la función <zipArchive variable>.CreateExe.
/TIT=<Title><Title> corresponde al título de la ventana de autoextracción.
/PID=<Num PID>Espera al final del proceso <PID Num> antes de iniciar la extracción.
/SILENTInicia la extracción sin barra de progreso ni cuadro de diálogo.
/WAITSi el archivo autoextraíble ejecuta un archivo .exe, la herramienta de autoextracción seguirá ejecutándose hasta que se cierre el archivo ejecutable.
/RELANCEExtracción con permisos de administrador.
Componente: wd300zip.dll
Versión mínima requerida
  • Versión 24
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 28/05/2025

Señalar un error o enviar una sugerencia | Ayuda local