This function is used to retrieve into the Buffer the string in the key (Key) included in the file (IniFile) section (Section).
If the key does not exist, Buffer will take the value of the Default parameter.
If the Buffer parameter is too small to contain the key value, this value will be truncated.
This function does not distinguish between upper- and lower-case characters in the Section and Key parameters.
If the value associated with the key has been defined using apostrophes or quotation marks, this function will delete them.
Context
Windows client,
Windows server,
Java client,
Java server,
Adelia Cloud client.
Parameters
ALPHA(n) |
IniFile |
Name of the ".ini" file. |
ALPHA(n) |
Section |
Registry section. |
ALPHA(n) |
Key |
Registry key. |
ALPHA(n) |
Buffer |
Variable resulting from the read operation. |
NUM_BIN_4 |
Size |
Size (n) of the Buffer parameter. |
ALPHA(n) |
Default |
Default key. |
Example
IniFile = 'User.ini'
Section = 'Profile'
Key = '0005'
Default = '0001'
Size = n
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxQueryValueStr' IniFile Section Key Buffer Size Default
List of the VaToolBx functions by topic