Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members Related Pages

# ACE_Configuration_Win32Registry Class Reference

The win32 registry implementation of a configuration database. More...

`#include <Configuration.h>`

Inheritance diagram for ACE_Configuration_Win32Registry:

[legend]
Collaboration diagram for ACE_Configuration_Win32Registry:

[legend]
List of all members.

## Public Methods
ACE_EXPLICIT | ACE_Configuration_Win32Registry (HKEY hKey)
| Constructor for registry configuration database. More...
virtual | ~ACE_Configuration_Win32Registry (void)
| Destructor. More...
virtual int | open_section (const ACE_Configuration_Section_Key &base, const ACE_TCHAR *sub_section, int create, ACE_Configuration_Section_Key &result)
| Opens a named section in an existing section. More...
virtual int | remove_section (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *sub_section, int recursive)
virtual int | enumerate_values (const ACE_Configuration_Section_Key &key, int Index, ACE_TString &name, VALUETYPE &type)
| Enumerates through the values in a section. More...
virtual int | enumerate_sections (const ACE_Configuration_Section_Key &key, int Index, ACE_TString &name)
| Enumerates through the subsections in a section. More...
virtual int | set_string_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, const ACE_TString &value)
virtual int | set_integer_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, u_int value)
virtual int | set_binary_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, const void *data, u_int length)
virtual int | get_string_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, ACE_TString &value)
virtual int | get_integer_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, u_int &value)
virtual int | get_binary_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, void *&data, u_int &length)
virtual int | find_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name, VALUETYPE &type)
| Retrieves the type of a named configuration value. More...
virtual int | remove_value (const ACE_Configuration_Section_Key &key, const ACE_TCHAR *name)
| Removes the the value <name> from <key>. returns non zero on error. More...
virtual int | operator== (const ACE_Configuration_Win32Registry &rhs) const
virtual int | operator!= (const ACE_Configuration_Win32Registry &rhs) const
## Static Public Methods
HKEY | resolve_key (HKEY hKey, const ACE_TCHAR *path, int create=1)
| This method traverses <path> through <hKey>. More...
## Protected Methods
int | load_key (const ACE_Configuration_Section_Key &key, HKEY &hKey)
| Gets the HKEY for a configuration section. More...
| ACE_Configuration_Win32Registry (void)
| ACE_Configuration_Win32Registry (const ACE_Configuration_Win32Registry &rhs)
ACE_Configuration_Win32Registry & | operator= (const ACE_Configuration_Win32Registry &rhs)

## Detailed Description

The win32 registry implementation of a configuration database.

The win32 implementation basically makes calls through to the registry functions. The API is very similar so very little work must be done

## Constructor & Destructor Documentation

ACE_EXPLICIT ACE_Configuration_Win32Registry::ACE_Configuration_Win32Registry | ( | HKEY | hKey | ) |

| Constructor for registry configuration database. hKey is the base registry key to attach to. This class takes ownership of hKey, it will invoke <RegCloseKey> on it upon destruction.

virtual ACE_Configuration_Win32Registry::~ACE_Configuration_Win32Registry | ( | void |  | ) | `[virtual]`

| Destructor.

ACE_Configuration_Win32Registry::ACE_Configuration_Win32Registry | ( | void |  | ) | `[protected]`

ACE_Configuration_Win32Registry::ACE_Configuration_Win32Registry | ( | const ACE_Configuration_Win32Registry & | rhs | ) | `[protected]`

## Member Function Documentation

virtual int ACE_Configuration_Win32Registry::enumerate_sections | ( | const ACE_Configuration_Section_Key & | key,
|  | int | Index,
|  | ACE_TString & | name
| ) | `[virtual]`

  | Enumerates through the subsections in a section. Parameters:
  key | Section key to iterate through.
  index | Iteration position. Must be zero on the first call to iterate through key. Increment index by one on each successive call to this method.
  name | Receives the subsection's name.
  Note: You may not modify the key section while enumerating. If the section is modified during enumeration, results are undefined; you must restart the enumeration from index 0. Return values:
  0 | for success, name has a valid name.
  1 | there are no more subsections in the section.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::enumerate_values | ( | const ACE_Configuration_Section_Key & | key,
|  | int | Index,
|  | ACE_TString & | name,
|  | VALUETYPE & | type
| ) | `[virtual]`

  | Enumerates through the values in a section. Parameters:
  key | Section key to iterate through.
  index | Iteration position. Must be zero on the first call to iterate through key. Increment index by one on each successive call to this method.
  name | Receives the value's name.
  type | Receives the value's data type.
  Note: You may not delete or add values while enumerating. If the section is modified during enumeration, results are undefined; you must restart the enumeration from index 0. Return values:
  0 | for success, name and type are valid.
  1 | there are no more values in the section.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::find_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | VALUETYPE & | type
| ) | `[virtual]`

  | Retrieves the type of a named configuration value. Parameters:
  key | Configuration section to look up the name in.
  name | Name of the configuration value to get the type of.
  type | Receives the data type of the named value, if it exists.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::get_binary_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | void *& | data,
|  | u_int & | length
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to get the value from.
  name | Name of the configuration value to get.
  data | Receives a pointer to memory holding the binary data for the value. This method allocates the memory pointed to using operator new[]. The caller is responsible for freeing the memory using operator delete[].
  length | Receives the number of bytes in the value.
  Return values:
  0 | for success; caller is responsible for freeing the returned memory.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::get_integer_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | u_int & | value
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to get the value from.
  name | Name of the configuration value to get.
  value | Receives the configuration value if it exists and has type INTEGER.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::get_string_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | ACE_TString & | value
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to get the value from.
  name | Name of the configuration value to get.
  value | Receives the configuration value if it exists and has type STRING.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

int ACE_Configuration_Win32Registry::load_key | ( | const ACE_Configuration_Section_Key & | key,
|  | HKEY & | hKey
| ) | `[protected]`

| Gets the HKEY for a configuration section.

virtual int ACE_Configuration_Win32Registry::open_section | ( | const ACE_Configuration_Section_Key & | base,
|  | const ACE_TCHAR * | sub_section,
|  | int | create,
|  | ACE_Configuration_Section_Key & | result
| ) | `[virtual]`

  | Opens a named section in an existing section. Parameters:
  base | Existing section in which to open the named section.
  sub_section | Name of the section to open.
  create | If zero, the named section must exist. If non-zero, the named section will be created if it does not exist.
  result | Reference; receives the section key for the new section.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::operator!= | ( | const ACE_Configuration_Win32Registry & | rhs | ) | const`[virtual]`

ACE_Configuration_Win32Registry& ACE_Configuration_Win32Registry::operator= | ( | const ACE_Configuration_Win32Registry & | rhs | ) | `[protected]`

virtual int ACE_Configuration_Win32Registry::operator== | ( | const ACE_Configuration_Win32Registry & | rhs | ) | const`[virtual]`

virtual int ACE_Configuration_Win32Registry::remove_section | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | sub_section,
|  | int | recursive
| ) | `[virtual]`

  | Parameters:
  key | Section key to remove the named section from.
  sub_section | Name of the section to remove.
  recursive | If non zero, any subkeys below sub_section are removed as well.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::remove_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name
| ) | `[virtual]`

| Removes the the value <name> from <key>. returns non zero on error. Reimplemented from ACE_Configuration.

HKEY ACE_Configuration_Win32Registry::resolve_key | ( | HKEY | hKey,
|  | const ACE_TCHAR * | path,
|  | int | create = 1
| ) | `[static]`

| This method traverses <path> through <hKey>. It is useful when you want the HKEY for a specific registry key, especially when initializing this implementation. Caller is responsible for closeing this key when it is no longer used. If create is 1 (default) the keys are create if they don't already exist. Returns 0 on error

virtual int ACE_Configuration_Win32Registry::set_binary_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | const void * | data,
|  | u_int | length
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to set the value in.
  name | Name of the configuration value to set. If a value with the specified name exists, it is replaced.
  data | Pointer to the binary data for the value.
  length | Number of bytes for the new value.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::set_integer_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | u_int | value
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to set the value in.
  name | Name of the configuration value to set. If a value with the specified name exists, it is replaced.
  value | The integer to set the configuration value to.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

virtual int ACE_Configuration_Win32Registry::set_string_value | ( | const ACE_Configuration_Section_Key & | key,
|  | const ACE_TCHAR * | name,
|  | const ACE_TString & | value
| ) | `[virtual]`

  | Parameters:
  key | Configuration section to set the value in.
  name | Name of the configuration value to set. If a value with the specified name exists, it is replaced.
  value | The string to set the configuration value to.
  Return values:
  0 | for success.
  -1 | for error; ACE_OS::last_error() retrieves error code.
Reimplemented from ACE_Configuration.

The documentation for this class was generated from the following file:

- Configuration.h