Regini.exe

Windows NT® Resource Kits

Contents

Introduction

Command-line syntax

Creating a Regini script file

Script file syntax

Line formatting

Registry Key names

Key name syntax

Kernel and User key names

ACLs

Value entries

Sample script files

Storing a user name for automatic administrative logon

Adding a value for the current user in the Exchange client subkey

Setting the default user name

Complex sample

Introduction

Regini is a command-line utility that you can use to edit the Windows NT Registry. Regini runs the scripts you write that add and modify Registry subkeys and value entries.

When you want to edit the Registry directly, use a Registry editor.

Caution

Changing the Registry by using a Registry editor can have unforeseen effects that can prevent you from starting your computer. Whenever possible, use programs such as Control Panel or System Policy Editor to configure Windows NT.

You can use Regini for batch implementation of corporate standards, including display, sound, and security settings. When you install new device drivers or hardware, however, use the Setup program provided for that purpose.

Command-line Syntax

To run Regini, at the command prompt, type:

regini ScriptFile [ScriptFile...]

where ScriptFile is the filename (and optionally the full path) of a script file used to modify the Windows NT Registry.

For example:

regini \\myserver\public\myfolder\srv.ini

runs Regini, and directs it to run a script file named Srv.ini from the shared folder \\Myserver\Public\Myfolder.

Creating a Regini Script File

Script File Syntax

In a Regini script file specifying Registry changes, you must locate the subkey containing the value entry to be added or changed on the first line, followed by the intended value of that value entry on the second line, using the following format:

\Registry\Key [ACL]ValueEntryName = DataType Value

where:

Keyis the name of the key or subkey containing the value entry you

wish to add or change

ValueEntryNameis the name of the value entry whose value is to be modified

DataTypeis the data type used by the value entry

Valueis the intended result

ACLis an access control list you can choose to include.

The elements of this syntax are explained in more detail below.

If a line contains an equal sign (=), then Regini interprets that line as specifying the value of a Registry value entry.

If a line does not contain an equal sign (=), Regini interprets that line as specifying the name of a Registry key or subkey.

Note

Make sure the text editor you use to create the script file inserts a carriage return at the end of each line. Missing carriage returns can cause unpredictable results.

For example, a Regini script file named Srv.ini, in the shared directory \\Myserver\Public\Myfolder, contains the following text:

The following, typed at the command prompt, adds the DiskSpaceThreshhold value entry to the Registry or changes the value that is already there:

regini \\myserver\public\myfolder\srv.ini

Note

Script files can have any extension. They must be saved in ANSI format, but are converted to Unicode when read from the disk. Currently, there is no way to specify a Unicode text file as the script file.

Line Formatting

The format of the script file is line-based. If you are unable to fit all the information for a Registry subkey name or value entry on one line, use the backslash character (\) as a line-continuation character.

For example:

123456\

1234 \

12

is treated as single line containing:

1234561234 12

Registry Key Names

Key Name Syntax

If a line does not contain an equal sign (=), then the line specifies the name of a Registry key or subkey. In a Regini script file, the subkey name consists of all text from the first non-blank character to the end of the line, including spaces, on any line that does not contain an equal sign.

Leading spaces are significant. If there are no leading spaces, then the named subkey is an absolute path in the Registry.

For example:

\Registry\Machine\Software

– or –

USER:Control Panel

In the second example, USER: is replaced by the full path to the root of the currently logged-on user's profile (for example, \Registry\Users\S-x-x-xxxx...).

If a line in the script file does not contain an equal sign, and there are one or more spaces at the beginning of that line, then the subkey name on that line is defined in relation to the subkey preceding it in the Registry hierarchy. If the number of leading spaces is the same as in the preceding subkey, then Regini locates the subkey at the same level. If the number of leading spaces is lower, Regini locates the subkey one level higher; if the number is higher, Regini locates the subkey one level lower.

For example:

\Registry\Machine\Software

Level1a

Level2a

Level2b

Level3a

Level1b

Kernel and User Key Names

Note that Regini works with Kernel Registry strings. When you access the Registry in User mode to modify the HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER, or HKEY_CURRENT_USER keys, the string is converted to the following in Kernel mode:

HKEY_LOCAL_MACHINE is converted to \Registry\Machine.

HKEY_USERS is converted to \Registry\User.

HKEY_CURRENT_USER is converted to \Registry\User\User_SID, where User_SID is the current user's security identifier (SID).

ACL

After the subkey name, you can optionally specify an access control list (ACL). The ACL is a list of decimal numbers separated by spaces within square brackets. The decimal numbers represent the following user rights:

1.Administrator Full

2.Administrator R

3.Administrator RW

4.Administrator RWD

5.Creator Full

6.Creator RW

7.World Full

8.World R

9.World RW

10.World RWD

11.Power Users Full

12.Power Users RW

13.Power Users RWD

14.System OpFull

15.System OpRW

16.System OpRWD

17.System Full

18.System RW

19.System R

20.Administrator RWX

Value Entries

If a line in a script file contains an equal sign (=), then that line specifies a value for a Registry value entry. The text to the left of the equal sign, if any, is the name of the value entry. The text to the right of the equal sign specifies the data type and value of the value entry. Syntax for specifying a value is as follows:

ValueEntryName = DataType Value

where:

ValueEntryNameis the name of the value entry.

DataTypeis the data type.

Valueis the value of the entry.

The value entry name consists of all characters from the first non-blank character on the line to the last non-blank character before the equal sign. The value consists of the first non-blank character after the data type to the end of the line.

Eight data type keywords are supported by Regini. If none is specified, the default data type, REG_SZ, is used. The data types and the format of the values for each are:

Sets the Registry

Data TypeValue Datadata type toNotes

REG_SZA stringREG_SZREG_SZ is the defaut

data type.

REG_EXPAND_SZA stringREG_EXPAND_SZ

REG_MULTI_SZOne or moreREG_MULTI_SZ

strings, each

within quotes

REG_MULTISZFILEA path to a fileREG_MULTI_SZThe file is opened and

each quoted string is

added to the value.

REG_DWORDA decimalREG_DWORDUse 0x to specify a

numberhexadecimal value, 0o

to specify an octal

value, and 0b to

specify a binary value.

You can use the

strings On, Yes, or

True, which are

converted to

0x00000001, and the

strings Off, No, or

False, which are

converted to

0x00000000.

REG_BINARYTwo or moreREG_BINARYThe first decimal

decimal numbersnumber must be the

number of bytes of

data that follow. The

remaining numbers are

converted into 32-bit

numbers. The value

length is always a

multiple of 4 bytes.

REG_BINARYFILEA path to a fileREG_BINARYThe named file is

opened and its

contents stored in the

Registry as the value.

The length of the value

is the length of the file.

DELETE[No value data][No data type]If this keyword is

specified as the data

type, the value entry

name is deleted.

Sample Script Files

The sample Regini script files included in this section show how to:

Store a user name to use for automatic logon

Add a value for the current user in the Exchange client subkey

Modify several Registry keys at the same time

Storing a user name for automatic administrative logon

This example shows how to use a Regini script to set a user name for an administrative account that can log on automatically to Windows NT.

Start the computer, and press ctrl+alt+del to log on to Windows NT. In the Logon Information dialog box, type a user name and password. The user name you type is stored in the DefaultUserName value entry in the Winlogon subkey of the Registry.

To ensure that the value of DefaultUserName never changes, create a script file containing the following text:

where DefaultUserName is the value name, REG_SZ is the data type and USERNAME is the desired result or value.

Note

To log on automatically to Windows NT, you must supply the password associated with the user name. The password is stored in the DefaultPassword value entry in the Winlogon subkey of the Registry. If no password was entered in the Logon Information dialog box, you do not need to supply a password in the script file.

To reference the script file, create a batch file containing the following command:

c:\reskit\regini c:\username.ini

where the name of the script file saved is Username.ini.

To ensure that the DefaultUserName will not change, however many users log on, place this batch file in the Systemroot\Profiles\All Users\Start Menu\Programs\Startup directory.

Adding a value for the current user in the Exchange client subkey

These examples show how to add a value entry for the current user in the Exchange subkey.

You can change the value of Exchange client options in either HKEY_USERS or HKEY_CURRENT_USER.

The following two sample scripts show how to use this information with Regini when you want to add or modify multiple Registry keys.

Example 1

Example 2

Setting the default user name

This example shows how to use Regini to set the default user name in the Logon Information dialog box. This script modifies HKEY_LOCAL_MACHINE.

Complex sample

The following scripts were obtained by running the Regdmp utility.