ceRegistryQueryValue (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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 from the registry of the Mobile Terminal (Pocket PC) connected to the current station.

Remark: 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.
If an error occurs, you can get the details of the error with 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.
If an error occurs, you can get the details of the error with 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

ceRegistryQueryValue and RegistryQueryValue have similar operating modes.

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 : wd260ce.dll