Hauptseite | Klassenhierarchie | Alphabetische Liste | Auflistung der Klassen | Auflistung der Dateien | Klassen-Elemente

# CWinRegKey Klassenreferenz

Klasse zum einfachen Zugriff auf die Windows Registry. Mehr...

`#include <WinRegKey.h>`

Aufstellung aller Elemente

## Öffentliche Methoden
| CWinRegKey ()
| Konstructor.
virtual | ~CWinRegKey ()
| Destructor.
| operator HKEY () const
| Konverteirt ein CWinRegKey objekt to zu HKEY.
HKEY | Detach (void)
| Löst das interne Handle m_hKey vom Objekt.
void | Attach (HKEY hKey)
| Bindet ein Handle an das interne Handle m_hKey.
LONG | Open (HKEY hKeyParent, LPCTSTR lpszKeyName, REGSAM nSamDesired=KEY_ALL_ACCESS)
| Öffnet einen Registry-Schlüssel.
LONG | Close ()
| Beendet den Zugriff auf den aktuellen Registry-Schlüssel.
LONG | Create (HKEY hKeyParent, LPCTSTR lpszKeyName, LPTSTR lpszClass=NULL, DWORD dwOptions=REG_OPTION_NON_VOLATILE, REGSAM nSamDesired=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES lpSecAttr=NULL, LPDWORD lpdwDisposition=NULL)
| Erzeugt einen neuen Registry-Schlüssel.
LONG | SetValue (DWORD dwValue, LPCTSTR lpszValueName)
| Setzt einen Registry-Wert vom aktuellen Schlüssel vom Typ DWORD.
LONG | SetValue (LPCTSTR lpszValue, LPCTSTR lpszValueName)
| Setzt einen Registry-Wert vom aktuellen Schlüssel vom Typ String.
LONG | QueryValue (DWORD &dwValue, LPCTSTR lpszValueName)
| Liest einen Registry-Wert vom aktuellen Schlüssel vom Typ DWORD.
LONG | QueryValue (LPTSTR szValue, LPCTSTR lpszValueName, DWORD *pdwCount)
| Liest einen Registry-Wert vom aktuellen Schlüssel vom Typ String.
LONG | DeleteSubKey (LPCTSTR lpszSubKey)
| Löscht einen Unterschlüssel des aktuelle Schlüssels aus der Registry.
LONG | RecurseDeleteKey (LPCTSTR lpszKey)
| Löscht einen Unterschlüssel des aktuelle Schlüssels inkl.
LONG | DeleteValue (LPCTSTR lpszValue)
| Löscht einen Wert aus der Registry.
LONG | EnumSubKeys (std::vector< std::string > &aKeyNames)
| Ermittelt die untergeordneten Schlüssel.
LONG | EnumValues (std::vector< std::string > &aValueNames)
| Ermittelt die vorhandenen Wertnamen.
## Private Attribute
HKEY | m_hKey

## Ausführliche Beschreibung

Klasse zum einfachen Zugriff auf die Windows Registry.

Basis-Code aus Microsoft VC++ 6.0 ATL-Bibliothek.

Autor:
  Axel Schmidt

## Dokumentation der Elementfunktionen

LONG CWinRegKey::Close | ( |  | ) |

| Beendet den Zugriff auf den aktuellen Registry-Schlüssel. Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::Create | ( | HKEY | hKeyParent,
|  | LPCTSTR | lpszKeyName,
|  | LPTSTR | lpszClass = `NULL`,
|  | DWORD | dwOptions = `REG_OPTION_NON_VOLATILE`,
|  | REGSAM | nSamDesired = `KEY_ALL_ACCESS`,
|  | LPSECURITY_ATTRIBUTES | lpSecAttr = `NULL`,
|  | LPDWORD | lpdwDisposition = `NULL`
| ) |

  | Erzeugt einen neuen Registry-Schlüssel. Parameter:
  | hKeyParent | Schlüssel, ab dem gesucht wird (Vordefinierte Schlüssel : HKEY_CLASSES_ROOT, HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE HKEY_USERS
  | lpszKeyName | Unterschlusselname (NULL oder "", falls kein Unteschlüssel gewünscht).
  | lspzClass | Class-String
  | dwOptions | Optionen (REG_OPTION_NON_VOLATILE, REG_OPTION_VOLATILE oder REG_OPTION_BACKUP_RESTORE)
  | nSamDesired | gewünschter Zugriffs-Modus
  | lpSecAttr | Security-Attribute
  | lpdwDisposition | REG_CREATED_NEW_KEY oder REG_OPENED_EXISTING_KEY
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::DeleteSubKey | ( | LPCTSTR | lpszSubKey | ) |

  | Löscht einen Unterschlüssel des aktuelle Schlüssels aus der Registry. Unter Win95 werden alle Unterschlüssel mitgelöscht, unter Windows NT können nur Schlüssel ohne Unterschlüssel gelöscht werden (Benutze RecurseDeleteDey anstatt). Parameter:
  | lpszSubKey | Name des Unterschlüssels
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::DeleteValue | ( | LPCTSTR | lpszValue | ) |

  | Löscht einen Wert aus der Registry. Parameter:
  | lpszValue | Name des Wertes
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

HKEY CWinRegKey::Detach | ( | void |  | ) |

| Löst das interne Handle m_hKey vom Objekt. Rückgabe: das aktuelle interne Handle

LONG CWinRegKey::EnumSubKeys | ( | std::vector< std::string > & | aKeyNames | ) |

  | Ermittelt die untergeordneten Schlüssel. Parameter:
  | aKeyNames | Feld mit den Schlüsseln.
Rückgabe: immer ERROR_SUCCESS

LONG CWinRegKey::EnumValues | ( | std::vector< std::string > & | aValueNames | ) |

  | Ermittelt die vorhandenen Wertnamen. Parameter:
  | aValueNames | Feld mit den Wertnamen.
Rückgabe: immer ERROR_SUCCESS

LONG CWinRegKey::Open | ( | HKEY | hKeyParent,
|  | LPCTSTR | lpszKeyName,
|  | REGSAM | nSamDesired = `KEY_ALL_ACCESS`
| ) |

  | Öffnet einen Registry-Schlüssel. Parameter:
  | hKeyParent | Schlüssel, ab dem gesucht wird (Vordefinierte Schlüssel : HKEY_CLASSES_ROOT, HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE HKEY_USERS
  | lpszKeyName | Unterschlusselname (NULL oder "", falls kein Unteschlüssel gewünscht).
  | nSamDesired | gewünschter Zugriffs-Modus
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

CWinRegKey::operator HKEY | ( |  | ) | const

| Konverteirt ein CWinRegKey objekt to zu HKEY. Rückgabe: HKEY

LONG CWinRegKey::QueryValue | ( | LPTSTR | szValue,
|  | LPCTSTR | lpszValueName,
|  | DWORD * | pdwCount
| ) |

  | Liest einen Registry-Wert vom aktuellen Schlüssel vom Typ String. Parameter:
  | lpszValue | Wert (darf nicht NULL sein)
  | lpszValueName | Wertname
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::QueryValue | ( | DWORD & | dwValue,
|  | LPCTSTR | lpszValueName
| ) |

  | Liest einen Registry-Wert vom aktuellen Schlüssel vom Typ DWORD. Parameter:
  | dwValue | Wert
  | lpszValueName | Wertname
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::RecurseDeleteKey | ( | LPCTSTR | lpszKey | ) |

  | Löscht einen Unterschlüssel des aktuelle Schlüssels inkl. aller Unterschlüssel aus der Registry. Parameter:
  | lpszKey | Name des Unterschlüssels
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::SetValue | ( | LPCTSTR | lpszValue,
|  | LPCTSTR | lpszValueName
| ) |

  | Setzt einen Registry-Wert vom aktuellen Schlüssel vom Typ String. Parameter:
  | lpszValue | Wert (darf nicht NULL sein)
  | lpszValueName | Wertname
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

LONG CWinRegKey::SetValue | ( | DWORD | dwValue,
|  | LPCTSTR | lpszValueName
| ) |

  | Setzt einen Registry-Wert vom aktuellen Schlüssel vom Typ DWORD. Parameter:
  | dwValue | Wert
  | lpszValueName | Wertname
Rückgabe: ERROR_SUCCESS, falls kein Fehler aufgetreten

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien:

- WinRegKey.h
- WinRegKey.cpp