ceRegistryFirstSubKey (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Registry of the Mobile Device
Managing errors
Equivalence
Registry of a Smartphone

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ceRegistryFirstSubKey (Function)

In french: ceRegistrePremièreSousClé

Identifies the key found after the specified key in the registry of the Mobile Device (Pocket PC) connected to the current computer.

Remark: To handle the registry of the Mobile Device, a connection must be established between the current computer and the Mobile Device (ceConnect).

Example

Path is string
// Find out the name of the primary key
Path = ceRegistryFirstSubKey()
// Browse all the sub-keys
WHILE Path <> ""
Path = ceRegistryNextKey(Path)
END

// Identify the first sub-key of "HKEY_LOCAL_MACHINE\SYSTEM"
ResSubKey = ceRegistryFirstSubKey("HKEY_LOCAL_MACHINE\SYSTEM")

Syntax

<Result> = ceRegistryFirstSubKey([<Key path>])

<Result>: Character string

Full path of first sub-key for the specified key,
Empty string ("") if no sub-key was found.

<Key path>: Optional character string (with quotes)

Full path of key to use. If this parameter is not specified, the path of first sub-key of "HKEY_CLASSES_ROOT" is returned.

Remarks

Registry of the Mobile Device

The following branches do not exist on a Mobile Device:

HKEY_PERFORMANCE_DATA,
HKEY_CURRENT_CONFIG,
HKEY_DYN_DATA.

Managing errors

Caution: ceRegistryFirstSubKey returns no error code. To find out whether an error was generated by this function, use the ErrorOccurred variable. If an error occurs, you can get the details of the error with ErrorInfo.

Equivalence

ceRegistryFirstSubKey and RegistryFirstSubKey have equivalent operating modes.

The only difference is:

ceRegistryFirstSubKey handles the registry of the Mobile Device from a WINDEV application.
RegistryFirstSubKey handles the registry of the Mobile Device only from a WINDEV Mobile application.

Registry of a Smartphone

The access to the registry may fail on some Smartphones. In this case, the ErrorOccurred variable is set to True.

Component : wd260ce.dll