ceRegistryQueryValue (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Registry of the Mobile Device
Equivalence
Registry of a Smartphone

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ceRegistryQueryValue (Function)

In french: ceRegistreLit

Reads the value of a register in the registry of the Mobile Device (Pocket PC) connected to the current computer.

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

Example

// Reads the "Language" value in the "HKEY_LOCAL_MACHINE\SOFTWARE\MyApp" key
// ResExecute is a boolean used to find out whether the value was read
ResRead = ceRegistryQueryValue("HKEY_LOCAL_MACHINE\SOFTWARE\MyApp", "Language", ResExecute)

IF ResExecute = True THEN
Info("The value was read and it is set to: " + ResRead)
END

Syntax

Reading a value identified by its name Hide the details

<Result> = ceRegistryQueryValue(<Key path> , <Value name> [, <Runtime>])

<Result>: Integer, buffer or character string according to the type of key read

Value read.
Empty string ("") if no value was read.
To find out the error details, use ErrorInfo.

<Key path>: Character string (with quotes)

Full path of key to read.

<Value name>: Character string (with quotes)

Name of value to read. The maximim size of this value cannot exceed 4 KB.

<Runtime>: Optional boolean

True if the value was read,
False otherwise.

Reading a value identified by its subscript Hide the details

<Result> = ceRegistryQueryValue(<Key path> , <Value subscript> [, <Runtime>])

<Result>: Integer, buffer or character string according to the type of key read

Value read,
Empty string ("") if no value was read.
To find out the error details, use ErrorInfo.

<Key path>: Character string (with quotes)

Full path of key to read.

<Value subscript>: Integer

Subscript of value to read.

<Runtime>: Optional boolean

True if the value was read,
False otherwise.

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.

Equivalence

The operating mode of ceRegistryQueryValue is equivalent to the operating mode of RegistryQueryValue.

The only difference is:

ceRegistryQueryValue handles the registry of the Mobile Device from a WINDEV application.
RegistryQueryValue 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 : wd240ce.dll