Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
When the length of an Argument is stated as being greater than 50, this is only true for Fields. Literal values are restricted to a maximum length of 50. This is especially true for the three arguments in this BIF. All the arguments are limited to a length of 50 unless a field is used.

Arguments

No.

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

R

Registry Root

e.g. HKEY_CLASSES_ROOT,
HKEY_LOCAL_MACHINE

1

256



2

u

R

Registry Path

e.g. WinZip\shell\open\command

1

256



3

u

O

Registry Key Name

If not specified the (Default) value for the specified path will be returned, otherwise specify the name of the key.

1

256



4

N

O

Registry Hive to use: 32 or 64
Any other value will use the default for the application. That is, a 32 bit application will write to wow6432 while a 64 bit application will write to wow6464.

This argument is ignored on a 32 bit operating system.

1

4

0

0

Return Values

No.

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

X

R

Registry Key Value
Refer to Key Value Note for details.

1

Unlimited


Unlimited

2

A

R

Return Code

OK – Key found and Value Returned
ER – Key could not be found

2

2



3

A

O

Value Type

S – String
B – Binary
D – DWORD
X – Expanded string. Can contain environment variables which will be expanded on return from this Built-In Function.

1

1



Anchor
KeyValueNote
KeyValueNote
Key Value Note

If a field value is saved by PUT_REGISTRY_VALUE, a field with the same type must be used to get the correct value by GET_REGISTRY_VALUE.

The table shows the supported field types for each key type.

Key Type

Supported Field Types

S & X

Alpha, BLOB, Boolean, Char, CLOB, Date, DateTime, Float, Integer, Packed, Signed, Time and Char.

B

Binary, VarBinary, Alpha, Char and String.

D

Alpha, Char, String and less than 8 bytes Integer.

Example

Values PUT and the returned value on a GET from the Registry.

Data Type

PUT

GET

S

ABC1234

ABC1234

D

7000

7000

D

9999999999

0 (the biggest number for DWORD is 4294967295)

D

–12

-12

B

AAAAA

AA AA 0A

B

WEWE

0E 0E (because 'W' is not a HEX number)