The C++ framework for developing highly scalable, high performance servers on Windows platforms.

• Home
• What
• Why
• How
• Who
• Products
• Pricing
• Blog
• Contact

Search

CRegistryKey Class Reference

Collaboration diagram for CRegistryKey:

[legend]

List of all members.

Public Types
typedef TRegKeyIterator < SubkeyIteratorImpl >	SubkeyIterator
typedef TRegKeyIterator < ValueIteratorImpl >	ValueIterator
Public Member Functions
	CRegistryKey (HKEY hKey)
	CRegistryKey (LPCTSTR pRemoteMachine, HKEY hKey)
	CRegistryKey (HKEY hKey, LPCTSTR pSubKey, REGSAM samDesired=KEY_ALL_ACCESS, LPCTSTR pRemoteMachine=nullptr)
	CRegistryKey (const CRegistryKey &rhs)
	~CRegistryKey ()
CRegistryKey &	operator= (const CRegistryKey &rhs)
CRegistryKey &	operator= (HKEY hKey)
CRegistryKey	OpenKey (LPCTSTR pSubKey, REGSAM samDesired=KEY_ALL_ACCESS) const
CRegistryKey	CreateKey (LPCTSTR pSubKey, LPCTSTR pClass=_T(""), DWORD dwOptions=REG_OPTION_NON_VOLATILE, REGSAM samDesired=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES pSecurityAttributes=nullptr) const
CRegistryKey	CreateOrOpenKey (LPCTSTR pSubKey, DWORD *pDisposition=nullptr, LPCTSTR pClass=_T(""), DWORD dwOptions=REG_OPTION_NON_VOLATILE, REGSAM samDesired=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES pSecurityAttributes=nullptr) const
void	DeleteKey (LPCTSTR pKeyName) const
void	DeleteKeyAndSubkeys (LPCTSTR pKeyName) const
bool	HasSubkey (LPCTSTR pSubKey, REGSAM samDesired=KEY_ALL_ACCESS) const
CRegistryKey	ConnectRegistry (LPCTSTR pMachineName) const
void	FlushKey () const
	operator HKEY () const
SubkeyIterator	BeginSubkeyIteration () const
SubkeyIterator	EndSubkeyIteration () const
bool	TryDeleteValue (LPCTSTR pValueName) const
void	DeleteValue (LPCTSTR pValueName) const
Value	QueryValue (LPCTSTR pValueName=nullptr) const
bool	QueryValue (LPCTSTR pValueName, LPBYTE *ppBytes, DWORD &cbBytes) const
bool	QueryValue (LPCTSTR pValueName, LPTSTR *ppString) const
bool	QueryValue (LPCTSTR pValueName, DWORD &dwValue) const
void	SetValue (LPCTSTR pValueName, const BYTE *pBytes, DWORD cbBytes) const
void	SetValue (LPCTSTR pValueName, LPCTSTR pValue, DWORD dwType=REG_SZ) const
void	SetValue (LPCTSTR pValueName, DWORD value, DWORD dwType=REG_DWORD) const
void	SetValue (const Value &value) const
ValueIterator	BeginValueIteration () const
ValueIterator	EndValueIteration () const
void	LoadKey (LPCTSTR pSubkeyName, LPCTSTR pFile) const
void	UnLoadKey (LPCTSTR pSubkeyName) const
void	SaveKey (LPCTSTR pFile, LPSECURITY_ATTRIBUTES pSecurityAttributes=nullptr) const
void	RestoreKey (LPCTSTR pFile, DWORD flags=0) const
void	ReplaceKey (LPCTSTR pNewFile, LPCTSTR pOldFile, LPCTSTR pSubkeyName=nullptr) const
PSECURITY_DESCRIPTOR	GetKeySecurity (SECURITY_INFORMATION securityInformation) const
void	SetKeySecurity (SECURITY_INFORMATION securityInformation, PSECURITY_DESCRIPTOR pSecurityDescriptor) const
void	NotifyChangeKeyValue (HANDLE hEvent, bool bSubKeys=false, DWORD dwNotifyFilter=REG_NOTIFY_CHANGE_LAST_SET) const
void	NotifyChangeKeyValue (bool bSubKeys=false, DWORD dwNotifyFilter=REG_NOTIFY_CHANGE_LAST_SET) const
Classes
class	Exception
class	SubkeyIteratorImpl
class	Value
class	ValueIteratorImpl

---

Member Typedef Documentation

typedef TRegKeyIterator<SubkeyIteratorImpl> SubkeyIterator

typedef TRegKeyIterator<ValueIteratorImpl> ValueIterator

---

Constructor & Destructor Documentation

CRegistryKey

(

HKEY

hKey

)

[explicit]

CRegistryKey	(	LPCTSTR	pRemoteMachine,
		HKEY	hKey
	)

CRegistryKey	(	HKEY	hKey,
		LPCTSTR	pSubKey,
		REGSAM	samDesired = KEY_ALL_ACCESS,
		LPCTSTR	pRemoteMachine = nullptr
	)

CRegistryKey

(

const CRegistryKey &

rhs

)

~CRegistryKey

(

)

---

Member Function Documentation

CRegistryKey & operator=

(

const CRegistryKey &

rhs

)

CRegistryKey & operator=

(

HKEY

hKey

)

CRegistryKey OpenKey	(	LPCTSTR	pSubKey,
		REGSAM	samDesired = KEY_ALL_ACCESS
	)			const

CRegistryKey CreateKey	(	LPCTSTR	pSubKey,
		LPCTSTR	pClass = _T(""),
		DWORD	dwOptions = REG_OPTION_NON_VOLATILE,
		REGSAM	samDesired = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	pSecurityAttributes = nullptr
	)			const

CRegistryKey CreateOrOpenKey	(	LPCTSTR	pSubKey,
		DWORD *	pDisposition = nullptr,
		LPCTSTR	pClass = _T(""),
		DWORD	dwOptions = REG_OPTION_NON_VOLATILE,
		REGSAM	samDesired = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	pSecurityAttributes = nullptr
	)			const

void DeleteKey

(

LPCTSTR

pKeyName

)

const

void DeleteKeyAndSubkeys

(

LPCTSTR

pKeyName

)

const

bool HasSubkey	(	LPCTSTR	pSubKey,
		REGSAM	samDesired = KEY_ALL_ACCESS
	)			const

CRegistryKey ConnectRegistry

(

LPCTSTR

pMachineName

)

const

void FlushKey

(

)

const

operator HKEY

(

)

const

CRegistryKey::SubkeyIterator BeginSubkeyIteration

(

)

const

CRegistryKey::SubkeyIterator EndSubkeyIteration

(

)

const

bool TryDeleteValue

(

LPCTSTR

pValueName

)

const

void DeleteValue

(

LPCTSTR

pValueName

)

const

CRegistryKey::Value QueryValue

(

LPCTSTR

pValueName = nullptr

)

const

bool QueryValue	(	LPCTSTR	pValueName,
		LPBYTE *	ppBytes,
		DWORD &	cbBytes
	)			const

bool QueryValue	(	LPCTSTR	pValueName,
		LPTSTR *	ppString
	)			const

bool QueryValue	(	LPCTSTR	pValueName,
		DWORD &	dwValue
	)			const

void SetValue	(	LPCTSTR	pValueName,
		const BYTE *	pBytes,
		DWORD	cbBytes
	)			const

void SetValue	(	LPCTSTR	pValueName,
		LPCTSTR	pValue,
		DWORD	dwType = REG_SZ
	)			const

void SetValue	(	LPCTSTR	pValueName,
		DWORD	value,
		DWORD	dwType = REG_DWORD
	)			const

void SetValue

(

const Value &

value

)

const

CRegistryKey::ValueIterator BeginValueIteration

(

)

const

CRegistryKey::ValueIterator EndValueIteration

(

)

const

void LoadKey	(	LPCTSTR	pSubkeyName,
		LPCTSTR	pFile
	)			const

void UnLoadKey

(

LPCTSTR

pSubkeyName

)

const

void SaveKey	(	LPCTSTR	pFile,
		LPSECURITY_ATTRIBUTES	pSecurityAttributes = nullptr
	)			const

void RestoreKey	(	LPCTSTR	pFile,
		DWORD	flags = 0
	)			const

void ReplaceKey	(	LPCTSTR	pNewFile,
		LPCTSTR	pOldFile,
		LPCTSTR	pSubkeyName = nullptr
	)			const

PSECURITY_DESCRIPTOR GetKeySecurity

(

SECURITY_INFORMATION

securityInformation

)

const

void SetKeySecurity	(	SECURITY_INFORMATION	securityInformation,
		PSECURITY_DESCRIPTOR	pSecurityDescriptor
	)			const

void NotifyChangeKeyValue	(	HANDLE	hEvent,
		bool	bSubKeys = false,
		DWORD	dwNotifyFilter = REG_NOTIFY_CHANGE_LAST_SET
	)			const

void NotifyChangeKeyValue	(	bool	bSubKeys = false,
		DWORD	dwNotifyFilter = REG_NOTIFY_CHANGE_LAST_SET
	)			const

---