D Programming Language 2.0

- Comments
- D
- Search
- Home

Last update Thu Sep 16 11:26:03 2010

# std.windows.registry

\file std/windows/registry.d This file contains the \c std.windows.registry.* classes

alias boolean;
  A strongly-typed Boolean

enum Endian;
  An enumeration representing byte-ordering (Endian) strategies

enum REGSAM;
  Enumeration of the recognised registry access modes

  \ingroup group_D_win32_reg

enum REG_VALUE_TYPE;
  Enumeration of the recognised registry value types

  \ingroup group_D_win32_reg

class RegistryException: std.windows.registry.Win32Exception;
  Exception class thrown by the std.windows.registry classes

  \ingroup group_D_win32_reg

  this(string message);
    \brief Creates an instance of the exception

    \param message The message associated with the exception \name Construction

  this(string message, int error);
    \brief Creates an instance of the exception, with the given

    \param message The message associated with the exception \param error The Win32 error number associated with the exception \name Construction

class Key;
  This class represents a registry key

  \ingroup group_D_win32_reg

  string name();
    The name of the key \name Attributes \name Construction

  uint keyCount();
    The number of sub keys \name Attributes \name Construction

  KeySequence keys();
    An enumerable sequence of all the sub-keys of this key \name Attributes \name Construction

  KeyNameSequence keyNames();
    An enumerable sequence of the names of all the sub-keys of this key \name Attributes \name Construction

  uint valueCount();
    The number of values \name Attributes \name Construction

  ValueSequence values();
    An enumerable sequence of all the values of this key \name Attributes \name Construction

  ValueNameSequence valueNames();
    An enumerable sequence of the names of all the values of this key \name Attributes \name Construction

  Key createKey(string name, REGSAM access);
    Returns the named sub-key of this key

    \param name The name of the subkey to create. May not be null \return The created key \note If the key cannot be created, a RegistryException is thrown. \name Methods \name Attributes \name Construction

  Key createKey(string name);
    Returns the named sub-key of this key

    \param name The name of the subkey to create. May not be null \return The created key \note If the key cannot be created, a RegistryException is thrown. \note This function is equivalent to calling CreateKey(name, REGSAM.KEY_ALL_ACCESS), and returns a key with all access \name Methods \name Attributes \name Construction

  Key getKey(string name, REGSAM access);
    Returns the named sub-key of this key

    \param name The name of the subkey to aquire. If name is null (or the empty-string), then the called key is duplicated \param access The desired access; one of the REGSAM enumeration \return The aquired key. \note This function never returns null. If a key corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  Key getKey(string name);
    Returns the named sub-key of this key

    \param name The name of the subkey to aquire. If name is null (or the empty-string), then the called key is duplicated \return The aquired key. \note This function never returns null. If a key corresponding to the requested name is not found, a RegistryException is thrown \note This function is equivalent to calling GetKey(name, REGSAM.KEY_READ), and returns a key with read/enum access \name Methods \name Attributes \name Construction

  void deleteKey(string name);
    Deletes the named key

    \param name The name of the key to delete. May not be null \name Methods \name Attributes \name Construction

  Value getValue(string name);
    Returns the named value

    \note if name is null (or the empty-string), then the default value is returned \return This function never returns null. If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, uint value);
    Sets the named value with the given 32-bit unsigned integer value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The 32-bit unsigned value to set \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, uint value, Endian endian);
    Sets the named value with the given 32-bit unsigned integer value, according to the desired byte-ordering

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The 32-bit unsigned value to set \param endian Can be Endian.Big or Endian.Little \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, ulong value);
    Sets the named value with the given 64-bit unsigned integer value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The 64-bit unsigned value to set \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, string value);
    Sets the named value with the given string value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The string value to set \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, string value, boolean asEXPAND_SZ);
    Sets the named value with the given string value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The string value to set \param asEXPAND_SZ If true, the value will be stored as an expandable environment string, otherwise as a normal string \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, string[] value);
    Sets the named value with the given multiple-strings value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The multiple-strings value to set \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void setValue(string name, byte[] value);
    Sets the named value with the given binary value

    \param name The name of the value to set. If null, or the empty string, sets the default value \param value The binary value to set \note If a value corresponding to the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void deleteValue(string name);
    Deletes the named value

    \param name The name of the value to delete. May not be null \note If a value of the requested name is not found, a RegistryException is thrown \name Methods \name Attributes \name Construction

  void flush();
    Flushes any changes to the key to disk

    \name Methods \name Attributes \name Construction

class Value;
  This class represents a value of a registry key

  \ingroup group_D_win32_reg

  string name();
    The name of the value.

    \note If the value represents a default value of a key, which has no name, the returned string will be of zero length \name Attributes

  REG_VALUE_TYPE type();
    The type of value \name Attributes

  string value_SZ();
    Obtains the current value of the value as a string.

    \return The contents of the value \note If the value's type is REG_EXPAND_SZ the returned value is not expanded; Value_EXPAND_SZ() should be called \note Throws a RegistryException if the type of the value is not REG_SZ, REG_EXPAND_SZ, REG_DWORD(*) or REG_QWORD(*): \name Attributes

  string value_EXPAND_SZ();
    Obtains the current value as a string, within which any environment variables have undergone expansion

    \return The contents of the value \note This function works with the same value-types as Value_SZ(). \name Attributes

  string[] value_MULTI_SZ();
    Obtains the current value as an array of strings

    \return The contents of the value \note Throws a RegistryException if the type of the value is not REG_MULTI_SZ \name Attributes

  uint value_DWORD();
    Obtains the current value as a 32-bit unsigned integer, ordered correctly according to the current architecture

    \return The contents of the value \note An exception is thrown for all types other than REG_DWORD, REG_DWORD_LITTLE_ENDIAN and REG_DWORD_BIG_ENDIAN. \name Attributes

  deprecated uint value_DWORD_LITTLEENDIAN();
    \name Attributes

  deprecated uint value_DWORD_BIGENDIAN();
    \name Attributes

  ulong value_QWORD();
    Obtains the value as a 64-bit unsigned integer, ordered correctly according to the current architecture

    \return The contents of the value \note Throws a RegistryException if the type of the value is not REG_QWORD \name Attributes

  deprecated ulong value_QWORD_LITTLEENDIAN();
    \name Attributes

  byte[] value_BINARY();
    Obtains the value as a binary blob

    \return The contents of the value \note Throws a RegistryException if the type of the value is not REG_BINARY \name Attributes

class Registry;
  Represents the local system registry.

  \ingroup group_D_win32_reg

  static Key classesRoot();
    Returns the root key for the HKEY_CLASSES_ROOT hive \name Hives

  static Key currentUser();
    Returns the root key for the HKEY_CURRENT_USER hive \name Hives

  static Key localMachine();
    Returns the root key for the HKEY_LOCAL_MACHINE hive \name Hives

  static Key users();
    Returns the root key for the HKEY_USERS hive \name Hives

  static Key performanceData();
    Returns the root key for the HKEY_PERFORMANCE_DATA hive \name Hives

  static Key currentConfig();
    Returns the root key for the HKEY_CURRENT_CONFIG hive \name Hives

  static Key dynData();
    Returns the root key for the HKEY_DYN_DATA hive \name Hives

class KeyNameSequence;
  An enumerable sequence representing the names of the sub-keys of a registry Key

  It would be used as follows:

  `Key key = . . .`
  ``
  `foreach(char[] kName; key.SubKeys)`
  `{`
  `process_Key(kName);`
  `}`

  \ingroup group_D_win32_reg

  uint count();
    The number of keys \name Attributes @{ Construction

  string getKeyName(uint index);
    The name of the key at the given index

    \param index The 0-based index of the key to retrieve \return The name of the key corresponding to the given index \note Throws a RegistryException if no corresponding key is retrieved \name Attributes @{ Construction

  string opIndex(uint index);
    The name of the key at the given index

    \param index The 0-based index of the key to retrieve \return The name of the key corresponding to the given index \note Throws a RegistryException if no corresponding key is retrieved \name Attributes @{ Construction

  int opApply(scope int delegate(ref string name) dg);
    @} \name Attributes @{ Construction

class KeySequence;
  An enumerable sequence representing the sub-keys of a registry Key

  It would be used as follows:

  `Key key = . . .`
  ``
  `foreach(Key k; key.SubKeys)`
  `{`
  `process_Key(k);`
  `}`

  \ingroup group_D_win32_reg

  uint count();
    The number of keys \name Attributes @{ Construction

  Key getKey(uint index);
    The key at the given index

    \param index The 0-based index of the key to retrieve \return The key corresponding to the given index \note Throws a RegistryException if no corresponding key is retrieved \name Attributes @{ Construction

  Key opIndex(uint index);
    The key at the given index

    \param index The 0-based index of the key to retrieve \return The key corresponding to the given index \note Throws a RegistryException if no corresponding key is retrieved \name Attributes @{ Construction

  int opApply(scope int delegate(ref Key key) dg);
    @} \name Attributes @{ Construction

class ValueNameSequence;
  An enumerable sequence representing the names of the values of a registry Key

  It would be used as follows:

  `Key key = . . .`
  ``
  `foreach(char[] vName; key.Values)`
  `{`
  `process_Value(vName);`
  `}`

  \ingroup group_D_win32_reg

  uint count();
    The number of values \name Attributes @{ Construction

  string getValueName(uint index);
    The name of the value at the given index

    \param index The 0-based index of the value to retrieve \return The name of the value corresponding to the given index \note Throws a RegistryException if no corresponding value is retrieved \name Attributes @{ Construction

  string opIndex(uint index);
    The name of the value at the given index

    \param index The 0-based index of the value to retrieve \return The name of the value corresponding to the given index \note Throws a RegistryException if no corresponding value is retrieved \name Attributes @{ Construction

  int opApply(scope int delegate(ref string name) dg);
    @} \name Attributes @{ Construction

class ValueSequence;
  An enumerable sequence representing the values of a registry Key

  It would be used as follows:

  `Key key = . . .`
  ``
  `foreach(Value v; key.Values)`
  `{`
  `process_Value(v);`
  `}`

  \ingroup group_D_win32_reg

  uint count();
    The number of values \name Attributes @{ Construction

  Value getValue(uint index);
    The value at the given index

    \param index The 0-based index of the value to retrieve \return The value corresponding to the given index \note Throws a RegistryException if no corresponding value is retrieved \name Attributes @{ Construction

  Value opIndex(uint index);
    The value at the given index

    \param index The 0-based index of the value to retrieve \return The value corresponding to the given index \note Throws a RegistryException if no corresponding value is retrieved \name Attributes @{ Construction

  int opApply(scope int delegate(ref Value value) dg);
    @} \name Attributes @{ Construction

Copyright © 1999-2010 by Digital Mars, All Rights Reserved | Page generated by Ddoc.