Chapter 6 WinReg

---

(Windows only)

Windows developers use this object to manipulate the content of the Windows registry.

WinReg Overview

This object does not have a public constructor. Instead, you construct an instance of this object by calling the getWinRegistry method of the Install object.

This discussion assumes you are already familiar with the Windows Registry. For information on it, see API documentation for Windows NT or Windows 95.

When you construct a WinReg object, it is set to operate with HKEY_CLASSES_ROOT as its root key. To use a different root key, use the setRootKey method. Typically values in the Windows Registry are strings. To manipulate such values, use the getValueString and setValueString methods. To manipulate other values, use the getValue and setValue methods.

Reading registry values is immediate. However, writing to the registry is delayed until performInstall is called.

Method Summary

createKey	Adds a key.
deleteKey	Removes a key.
deleteValue	Removes the value of an arbitrary key.
enumKeys	Retrieves the registry subkeys for the given key.
enumValueNames	Retrieves the value of a given subkey.
getValue	Retrieves the value of an arbitrary key.
getValueNumber	Retrieves the value of a key, when that value is an integer.
getValueString	Retrieves the value of a key, when that value is a string.
isKeyWritable	Returns whether the given key is writable.
keyExists	Returns whether the given key exists or is readable.
keyExists	Changes the root key being accessed.
setValue	Sets the value of an arbitrary key.
setValueNumber	Sets the value of a key, when that value is an integer.
setValueString	Sets the value of a key, when that value is a string.
valueExists	Returns whether the given value exists.
winRegValue	Creates a WinRegValue object.