Products Downloads


French version


 

 

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.
If IniFile does not contain a full access path, the system will look for the file in the Windows directory.

ALPHA(n)

Section

Registry section.
If the value is "*BLANK", the function will copy all the sections found in the file. Each section will be separated using the character with the hexadecimal value '01'.

ALPHA(n)

Key

Registry key.
If the value is "*BLANK", the function will copy all the keys found in the section specified in Section. This special case can be used to list all the keys in a file. Each key will be separated using the character with the hexadecimal value '01'. The last key read will not be followed by a character with the hexadecimal value '01'.

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

 

↑ Top of page


  • Aucune étiquette