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:
Erzeugt am Tue Mar 11 14:25:05 2008 für SchunkFPS von doxygen 1.3.7