Connection Information

To perform the requested action, WordPress needs to access your web server. Please enter your FTP credentials to proceed. If you do not remember your credentials, you should contact your web host.

Connection Type

RegistrySet – PB Docs 2018 – PowerBuilder Library

RegistrySet – PB Docs 2018

RegistrySet

PowerScript function

Description

Sets the value for a key and value name in the system registry. If
the key or value name does not exist, RegistrySet creates a new key or
name and sets its value.

Syntax

Argument

Description

key

A string whose value names the key in the system
registry whose value you want to set.

To uniquely
identify a key, specify the list of parent keys above it in the
hierarchy, starting with the root key. The keys in the list are
separated by backslashes.

If key does not exist in the
registry, RegistrySet creates a new key. To create a key without a
named value, specify an empty string for valuename.

valuename

A string containing the name of a value in the
registry. Each key may have several named values. To specify the
unnamed value, specify an empty string.

If
valuename does not exist in the registry, RegistrySet causes a new
name to be created for key.

valuetype

A value of the RegistryValueType enumerated datatype
identifying the datatype of a value in the registry. Values
are:

  • RegString! — A null-terminated string

  • RegExpandString! — A null-terminated string that
    contains unexpanded references to environment
    variables

  • RegBinary! — Binary data

  • ReguLong! — A 32-bit number

  • ReguLongBigEndian! — A 32-bit number

  • RegLongLong! — A 64-bit number which is the longlong
    type ranging from 0 – 9,223,372,036,854,775,807, because the
    registry key value cannot accept a negative number.

  • RegLink! — A Unicode symbolic link

  • RegMultiString! — An unbounded array of
    strings

value

A variable corresponding to the datatype of
valuetype containing a value to be set in the
registry.

Return value

Integer. Returns 1 if it succeeds and -1 if an error occurs. An
error is returned if the datatype of valuevariable does not correspond to
the datatype specified in valuetype.

Usage

Long string values (more than 2048 bytes) should be stored as files
and the file name stored in the registry.

Item

Description

Key

An element in the registry. A key is part of a tree
of keys, descending from one of the predefined root keys. Each key
is a subkey or child of the parent key above it in the
hierarchy.

There are four root
strings:

  • HKEY_CLASSES_ROOT

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

  • HKEY_CURRENT_USER

A key is uniquely identified by the list of
parent keys above it. The keys in the list are separated by
slashes, as shown in these examples:

Value name

The name of a value belonging to the key. A key can
have one unnamed value and one or more named
values.

Value type

A value identifying the datatype of a value in the
registry.

Value

A value associated with a value name or an unnamed
value. Several string, numeric, and binary datatypes are supported
by the registry.

Examples

This example sets a value for the key Fonts and the value name
Title:

This statement sets a value for the key Fonts and the value name
NameOfEntryNum:

See also

RegistryDelete

RegistryGet

RegistryKeys

RegistryValues


Document get from Powerbuilder help
Thank you for watching.
Was this article helpful?
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x