RegistryKeys

PowerScript function

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 )

1	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.

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.

Return value

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

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

string ls_subkeylist[]
integer li_rtn
li_rtn = RegistryKeys("HKEY_CLASSES_ROOTMyApp", &amp;
    ls_subkeylist)
IF li_rtn = -1 THEN
    ... // Error processing
END IF

string ls_subkeylist[]

integer li_rtn

li_rtn = RegistryKeys("HKEY_CLASSES_ROOTMyApp", &

ls_subkeylist)

IF li_rtn = -1 THEN

... // Error processing

END IF

See also

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 2018

August 20, 2023

Was this article helpful?

Connection Information

RegistryKeys – PB Docs 2018

RegistryKeys

PowerScript function

My Website Links