ceRegistrySetValue (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

The "(default)" entries
Registry of the Mobile Device
Equivalence
Registry of a Smartphone

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ceRegistrySetValue (Function)

In french: ceRegistreEcrit

Writes a value into a register of the registry on the Mobile Device (Pocket PC) connected to the current computer.

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

Example

// Write the "English" value into the "Language" value
// in the "HKEY_LOCAL_MACHINE\SOFTWARE\MyApp" key
ResWrite = ceRegistrySetValue("HKEY_LOCAL_MACHINE\SOFTWARE\MyApp", "Language", "English")

Syntax

Writing a value identified by its name into a registry Hide the details

<Result> = ceRegistrySetValue(<Key path> , <Value name> , <Value> [, <Length>])

<Result>: Boolean

True if the value was written,
False otherwise. To find out the error details, use ErrorInfo.

<Key path>: Character string (with quotes)

Full path of key to use.
Caution: The key must already exists before a value can be written. To create a key, use ceRegistryCreateKey.

<Value name>: Character string (with quotes)

Name of the value to write.

<Value>: Character string, integer, real or pointer

Value to write. The maximum size of this value cannot exceed 4 KB.

<Length>: Optional integer

Length of the value to write when <Value> corresponds to a pointer.

Writing a value identified by its subscript into a registry Hide the details

<Result> = ceRegistrySetValue(<Key path> , <Value subscript> , <Value> [, <Length>])

<Result>: Boolean

True if the value was written,
False otherwise. To find out the error details, use ErrorInfo.

<Key path>: Character string (with quotes)

Full path of key to use.
Caution: The key must already exists before a value can be written. To create a key, use ceRegistryCreateKey.

<Value subscript>: Integer

Subscript of the value to write.

<Value>: Character string, integer, real or pointer

Value to write. The maximum size of this value cannot exceed 4 KB.

<Length>: Optional integer

Length of the value to write when <Value> corresponds to a pointer.

Remarks

The "(default)" entries

To write a value into the "(default)" entries, use an empty string ("") instead of the name of the key.

For example:

Not to do:

ceRegistrySetValue("HKEY_CLASSES_ROOT\.jar", "(by default)", "myfile")

Do:

ceRegistrySetValue("HKEY_CLASSES_ROOT\.jar", "myfile")

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 ceRegistrySetValue is equivalent to the operating mode of RegistrySetValue.

The only difference is:

ceRegistrySetValue handles the registry of the Mobile Device from a WINDEV application.
RegistrySetValue 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 : wd250ce.dll