Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter SixteenApplication (continued)

RegistryCreateKey Function

Overview

The RegistryCreateKey function creates a key or keys entry at a specified location.

Syntax/Parameters

Syntax

int = RegistryCreateKey ( string key );

Parameters

key

A string containing the name of the key to access.

Return Value

An int as ERROR_NONE or a formatted error code on failure. If the key tree already exists, the function will return ERROR_CANCEL ORed with ERROR_FILE_EXISTS (82000050).

Remarks

The specified key name can contain multiple new nodes. The RegistryCreateKey function creates all missing keys in the specified path. An application can take advantage of this behavior to create several keys at once. For example, an application can create a subkey four levels deep at the same time as the three preceding subkeys by specifying a string of the following form for the key parameter:

subkey1\subkey2\subkey3\subkey4

Note that this behavior will result in creation of unwanted keys if an existing key in the path is spelled incorrectly.

The RegistrySetValue function will also automatically create the key name(s).

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic