AGETFILEVERSION( ) (Función)
Crea una matriz que contiene información acerca de archivos con recursos de versión de Windows como los archivos .exe, .dll y .fll, o de servidores de automatización creados en Visual FoxPro.
AGETFILEVERSION(ArrayName, cFileName)
Valores devueltos
Numeric
Parámetros
ArrayName
Especifica el nombre de la matriz en la que se coloca la información del archivo. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si la matriz existe y no es suficientemente grande para contener la información del archivo, Visual FoxPro aumenta automáticamente el tamaño de la matriz. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño.La siguiente tabla muestra el contenido de cada elemento de la matriz.
Elemento Contenido 1 Comentarios 2 Nombre de compañía 3 Descripción de archivo 4 Versión de archivo 5 Nombre interno 6 Copyright legal 7 Marcas comerciales legales 8 Nombre de archivo original 9 Versión privada 10 Nombre de producto 11 Versión de producto El formato de este valor depende de la versión de Visual FoxPro. Para obtener información detallada, vea VERSION( ) (Función).
12 Versión especial 13 Autoregistro OLE (contiene "OLESelfRegister" si el archivo admite autoregistro; de lo contrario contiene la cadena vacía) 14 Idioma (derivado del Código de traducción) 15 Código de traducción Por ejemplo, puede usar el código siguiente para determinar el Id. de configuración regional para el archivo ejecutable de Visual FoxPro:
DIMENSION aFiles[1] AGETFILEVERSION(aFiles,"VFP7.EXE") ? EVAL("0x"+LEFT(aFiles[15],4)) ** Returns 1033 for US version
cFileName
Especifica el nombre y opcionalmente la ruta de acceso del archivo de destino.
Observaciones
AGETFILEVERSION( ) se suele utilizar para obtener información acerca de archivos con recursos de la versión de Windows, tales como archivos .exe, .dll y .fll, o servidores de automatización creados en Visual FoxPro. Debe especificar un valor para por lo menos un elemento del cuadro de diálogo Versión EXE para que un servidor de automatización de Visual FoxPro tenga recursos de la versión de Windows.
AGETFILEVERSION( ) devuelve el número de elementos contenidos en la matriz. Si el archivo que especifica no existe o no contiene recursos de la versión de Windows, se devuelve el valor cero y la matriz (si se creó) no sufre cambios.
El número mínimo de caracteres a los que se puede abreviar AGETFILEVERSION( ) es 5.