PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Password
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
HModifyStructure (Function)
In french: HModifieStructure
HFSQLHFSQL Client/ServerAvailable only with these kinds of connection
Allows you to update the structure of a HFSQL data file by performing an automatic data modification (also called Synchronization of the Structure of Deployed Data).
Caution: Links are not managed (no creation or update of existing links).
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android This function is now available for the Android applications (for the HFSQL data files).
Java This function is now available for the Java applications.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android This function is now available for the Android applications (for the HFSQL data files).
Java This function is now available for the Java applications.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android This function is now available for the Android applications (for the HFSQL data files).
Java This function is now available for the Java applications.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
// Update the structure of data file Customer in the background
HModifyStructure(Customer, hmsBackgroundTask)
Syntax
<Result> = HModifyStructure(<Data file> [, <Option> [, <New password> [, <Backup> [, <Progress Bar>]]]])
<Result>: Boolean
  • True if the automatic data modification was performed,
  • False otherwise. ErrorInfo and HErrorInfo are used to identify the error.
<Data file>: Character string (with or without quotes)
Name of data file (defined in the analysis) whose structure must be updated.
If this parameter is equal to "*", the automatic data modification will be applied to all the known data files (described in the analysis).
This parameter can also correspond to the name of a group of files (or custom-folder) defined in the analysis (not available in Android and Android Widget).
<Option>: Optional constant (or combination of constants)
Options for the automatic data modification:
hmsNormal
(Default value)		Default operating mode of the automatic data modification.
hmsNoCheckThe automatic data modification is performed even if:
  • the description of the file is more recent than the description of the analysis,
  • the GUID of the file differs from the GUID of the analysis.
hmsBackgroundTaskA hot automatic modification is performed (available for the HFSQL Client/Server data files only).
Universal Windows 10 App This constant is not available.

Note: In hmsNormal or hmsNoCheck mode, the data file used must not be opened (by the application or by another application).
<New password>: Optional character string (with quotes)
  • New password of the data file.
  • Empty string ("") to delete the password.
If this parameter is not specified (or if this parameter corresponds to NULL), the existing password is not modified.
<Backup>: Optional character string (with quotes)
  • Backup directory.
  • Empty string ("") to perform no backup (default value).
<Progress Bar>: Optional character string (with or without quotes)
Name of Progress Bar control or name of window used to show the progress of automatic data modification.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 AppJava This parameter is not available.
Remarks

Password

If HModifyStructure is the first function that handles the specified data file, the password is checked when using the data file. This password must have been specified by HPass. If the password is incorrect:
Component : wd240hf.dll
See also
Minimum version required
  • Version 17
This page is also available for…
Comments
EXAMPLE
//Globais
iniresult is string = INIRead("APP","VERSAO","",fDataDir() + ["\"] +"CONFIG.INI")

IF (Num = 1 AND iniresult = "") OR (Num = 1 AND iniresult = 0) THEN

Info("UMA VEZ")

INIWrite("APP","VERSAO","2",fDataDir() + ["\"] +"CONFIG.INI")

Info(INIRead("APP","VERSAO","","CONFIG.INI"))

fDelete(fDataDir() + ["\"] +"t000_config.fic")
fDelete(fDataDir() + ["\"] +"t000_config.ndx")
fDelete(fDataDir() + ["\"] +"t000_config.mmo")

END

HModifyStructure("*",hmsBackgroundTask)

HCreationIfNotFound("*","APP634") //SENHA DOS ARQUIVOS
BOLLER
06 Oct. 2017