Syntax

[C/C++:]
void gReturnRegistryKeys(int registry, char *key, int *nkey, char *subkeys[], int len);

[F90:]
subroutine gReturnRegistryKeys(registry, key, nkey, subkeys)

integer,           intent(in) :: registry
character*(*),  intent(in) :: key
integer,           intent(inout) :: nkey
character*(*),  intent(out) :: subkeys(nkey)

Arguments

registry
Top level registry root key

= GREGCLASSESROOT,

Root classes registry

= GREGCURRENTUSER,

Current User Registry

= GREGLOCALMACHINE,

Local Machine Registry

= GREGUSERS,

Users Registry

= GREGCURRENTCONFIG,

Current Configuration Registry

key
Name of key for which subkeys names are required (blank if top level)

nkey
Size of subkey array on entry and number of subkeys returned on exit

subkeys
Character array containing returned subkeys

len
Length of subkeys array string argument (C/C++ only)

Description

The routine gReturnRegistryKeys() returns the names of any subkeys that exist under an existing key in the top level registry within the Windows Registry. The argument nkey should be set to the size of the subkeys array and will be returned as the number of subkeys returned (up to a maximum of the value set on entry). The function gEnqRegistryKeyInfo() can be used to obtain numbers and sizes of subkeys that are contained in the registry.

In C/C++ the application should declare subkeys as 'char subkeys*[len+1];' in order to allocate enough space for the returned subkey names plus their trailing NULLs. The maximum length can also be obtained from the results of a call to the function gEnqRegistryKeyInfo().

See Also

gReturnRegistryKeys Usage
gEnqRegistryKeyInfo

---