(Windows only)
Searches the current environment for a particular key and places its value into a particular data item.
A CHARACTER expression that specifies the name of the section that contains the key of interest.
In initialization files, section names appear in square brackets([]). When you specify a section name in the GET-KEY-VALUE statement, omit the square brackets.
A CHARACTER expression that specifies the name of the key of interest.
If you specify the Unknown value (?) or the empty string (""), GET-KEY-VALUE returns a comma-separated list of all keys in the section you specified.
Some applications store data in the registry under the default key of a section. This option lets you retrieve this data. For an example, see the EXAMPLES section of this entry.
This option applies only to the registry and not to initialization files.
If the current environment resides in the registry, the GET-KEY-VALUE statement:
If the current environment resides in an initialization file, the GET-KEY-VALUE statement:
Assigns the value of MYKEY to the variable MYVARIABLE as shown in the following example:
If the current environment is the registry, the GET-KEY-VALUE statement:
If the current environment resides in an initialization file, the following example returns a comma-separated list of all section names in the initialization file:
If the current environment resides in the registry, the GET-KEY-VALUE statement:
If the current environment resides in an initialization file, the GET-KEY-VALUE statement:
Returns a comma-separated list of all key names in MYSECTION; for example:
If the current environment resides in the registry, the following examples return a comma-separated list of subkeys under the current environment location and all value names directly under the current environment location. The delimiter @value@ separates the subkey names from the value names.
If the current environment resides in an initialization file, the following examples return a comma-separated list of all section names in the initialization file:
If the current environment resides in the registry, the GET-KEY-VALUE statement:
If the current environment resides in an initialization file, the following example returns an error:
The current environment might be the registry or an initialization file. The registry consists of sections called keys and subkeys arranged in a hierarchy. Keys and subkeys contain value entries, each of which consists of a value name and value data. Initialization files, by contrast, consist of a single level of sections. Sections contain entries, each of which consists of a name, an equals sign (=), and a value.
For more information on environments, see the chapter on colors and fonts in OpenEdge Development: Programming Interfaces.