RegistryKeys

Description

Obtains a list of the keys that are child items (subkeys) one level below a key in the Windows system registry.

Syntax

RegistryKeys ( key, subkeys )

Argument

Description

key

A string whose value names the key in the system registry whose subkeys you want.

To uniquely identify a key, specify the list of parent keys above it in the hierarchy, starting with the root key. The keys in the list are separated by backslashes.

subkeys

An array variable of strings in which you want to store the subkeys.

If the array is variable size, its upper bound will reflect the number of subkeys found.

If the array is fixed size, it must be large enough to hold all the subkeys. However, there will be no way to know how many subkeys were actually found.

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs.

Usage

For more information about entries in the system registry, see RegistrySet.

Examples

Example 1

This example obtains the subkeys associated with the key HKEY_CLASSES_ROOT\MyApp. The subkeys are stored in the variable-size array ls_subkeylist:

string ls_subkeylist[]

integer li_rtn

li_rtn = RegistryKeys("HKEY_CLASSES_ROOT\MyApp", &

    ls_subkeylist)

IF li_rtn = -1 THEN

    ... // Error processing

END IF

See also