ACE_Registry::Naming_Context Class Reference

An context representation. More...

#include <Registry.h>

Collaboration diagram for ACE_Registry::Naming_Context:

Public Types
enum	{ MAX_OBJECT_NAME_SIZE = BUFSIZ , MAX_CONTEXT_NAME_SIZE = MAXPATHLEN + 1 }

Public Member Functions
	Naming_Context ()
	Empty constructor: keys will be NULL.
	Naming_Context (const HKEY &key)
	Constructor: key_ will be set to key.
	~Naming_Context ()
	Destructor will call <Naming_Context::close>.
int	bind_new (const Name &name, const Object &object)
int	bind_new (const ACE_TString &name, const Object &object)
int	bind (const Name &name, const Object &object)
int	bind (const ACE_TString &name, const Object &object)
int	rebind (const Name &name, const Object &object)
int	rebind (const ACE_TString &name, const Object &object)
	Update <object> with name in this context.
int	resolve (const Name &name, Object &object)
int	resolve (const ACE_TString &name, Object &object)
	Find <object> with name in this context.
int	unbind (const Name &name)
int	unbind (const ACE_TString &name)
	Delete object with name in this context.
int	new_context (Naming_Context &naming_context)
	Create new naming_context.
int	bind_new_context (const Name &name, Naming_Context &naming_context, u_long persistence=REG_OPTION_NON_VOLATILE, u_long security_access=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES security_attributes=0)
int	bind_new_context (const ACE_TString &name, Naming_Context &naming_context, u_long persistence=REG_OPTION_NON_VOLATILE, u_long security_access=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES security_attributes=0)
int	bind_context (const Name &name, Naming_Context &naming_context, u_long persistence=REG_OPTION_NON_VOLATILE, u_long security_access=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES security_attributes=0)
int	bind_context (const ACE_TString &name, Naming_Context &naming_context, u_long persistence=REG_OPTION_NON_VOLATILE, u_long security_access=KEY_ALL_ACCESS, LPSECURITY_ATTRIBUTES security_attributes=0)
int	rebind_context (const Name &name, Naming_Context &naming_context)
int	rebind_context (const ACE_TString &name, Naming_Context &naming_context)
	Rename <naming_context> to name.
int	resolve_context (const Name &name, Naming_Context &naming_context, u_long security_access=KEY_ALL_ACCESS)
int	resolve_context (const ACE_TString &name, Naming_Context &naming_context, u_long security_access=KEY_ALL_ACCESS)
	Find <naming_context> with name in this context.
int	unbind_context (const Name &name)
int	unbind_context (const ACE_TString &name)
	Remove naming_context with name from this context.
int	destroy ()
	Same as <unbind_context> with this as naming_context.
int	list (u_long how_many, Binding_List &list, Binding_Iterator &iterator)
int	list (Binding_List &list)
int	flush ()
	Sync content of context to disk.
int	close ()
HKEY	key ()
	Get key.
HKEY	parent ()
	Get parent.
void	name (Name &name)
void	name (ACE_TString &name)
	Set name (String version)
ACE_TString	name ()
	Get name (String version)

Protected Member Functions
void	key (HKEY key)
	Set key.
void	parent (HKEY parent)
	Set parent.
void	name (const Name &name)
void	name (const ACE_TString &name)

Private Member Functions
	Naming_Context (const Naming_Context &rhs)
	Disallow copy constructors.
const Naming_Context &	operator= (const Naming_Context &rhs)
	Disallow assignment.

Private Attributes
HKEY	key_
	Key for self.
HKEY	parent_key_
	Key for parent.
ACE_TString	name_
	Name of self.

Friends
class	ACE_Predefined_Naming_Contexts
	Friend factory.

Detailed Description

An context representation.

Think about a context as being similar to a directory in a file system.

Member Enumeration Documentation

anonymous enum

anonymous enum

Enumerator
MAX_OBJECT_NAME_SIZE	Max sizes of names (Not too sure about this value)
MAX_CONTEXT_NAME_SIZE	Max size of context name.

Constructor & Destructor Documentation

Naming_Context() [1/3]

ACE_Registry::Naming_Context::Naming_Context

(

)

Empty constructor: keys will be NULL.

Naming_Context() [2/3]

ACE_Registry::Naming_Context::Naming_Context

(

const HKEY &

key

)

Constructor: key_ will be set to key.

~Naming_Context()

ACE_Registry::Naming_Context::~Naming_Context

(

)

Destructor will call <Naming_Context::close>.

Naming_Context() [3/3]

ACE_Registry::Naming_Context::Naming_Context ( const Naming_Context & rhs )

private

Disallow copy constructors.

Member Function Documentation

bind() [1/2]

int ACE_Registry::Naming_Context::bind	(	const ACE_TString &	name,
		const Object &	object )

Insert or update <object> with name into this context This will not fail if name already exists (String version)

bind() [2/2]

int ACE_Registry::Naming_Context::bind	(	const Name &	name,
		const Object &	object )

Insert or update object with name into this context This will not fail if name already exists (Name version)

bind_context() [1/2]

int ACE_Registry::Naming_Context::bind_context	(	const ACE_TString &	name,
		Naming_Context &	naming_context,
		u_long	persistence = REG_OPTION_NON_VOLATILE,
		u_long	security_access = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	security_attributes = 0 )

Insert or update <naming_context> with name relative to this context This will not fail if name already exists

bind_context() [2/2]

int ACE_Registry::Naming_Context::bind_context	(	const Name &	name,
		Naming_Context &	naming_context,
		u_long	persistence = REG_OPTION_NON_VOLATILE,
		u_long	security_access = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	security_attributes = 0 )

Insert or update <naming_context> with name relative to this context This will not fail if name already exists (Name version)

bind_new() [1/2]

int ACE_Registry::Naming_Context::bind_new	(	const ACE_TString &	name,
		const Object &	object )

Insert object with name into this context This will fail if name already exists (String version)

bind_new() [2/2]

int ACE_Registry::Naming_Context::bind_new	(	const Name &	name,
		const Object &	object )

Insert object with name into this context. This will fail if name already exists (Name version)

bind_new_context() [1/2]

int ACE_Registry::Naming_Context::bind_new_context	(	const ACE_TString &	name,
		Naming_Context &	naming_context,
		u_long	persistence = REG_OPTION_NON_VOLATILE,
		u_long	security_access = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	security_attributes = 0 )

Insert <naming_context> with name relative to this context This will fail if name already exists

bind_new_context() [2/2]

int ACE_Registry::Naming_Context::bind_new_context	(	const Name &	name,
		Naming_Context &	naming_context,
		u_long	persistence = REG_OPTION_NON_VOLATILE,
		u_long	security_access = KEY_ALL_ACCESS,
		LPSECURITY_ATTRIBUTES	security_attributes = 0 )

Insert <naming_context> with name relative to this context This will fail if name already exists (Name version)

close()

int ACE_Registry::Naming_Context::close

(

)

Close the handle of the context

Note

<close> does not call <flush>

destroy()

int ACE_Registry::Naming_Context::destroy

(

)

Same as <unbind_context> with this as naming_context.

flush()

int ACE_Registry::Naming_Context::flush

(

)

Sync content of context to disk.

key() [1/2]

HKEY ACE_Registry::Naming_Context::key

(

)

Get key.

key() [2/2]

void ACE_Registry::Naming_Context::key ( HKEY key )

protected

Set key.

list() [1/2]

int ACE_Registry::Naming_Context::list

(

Binding_List &

list

)

listing function: iterator creator This gives back a listing of all entries in this context.

list() [2/2]

int ACE_Registry::Naming_Context::list	(	u_long	how_many,
		Binding_List &	list,
		Binding_Iterator &	iterator )

listing function: iterator creator This is useful when there are many objects and contexts in this context and you only want to look at a few entries at a time

name() [1/5]

ACE_TString ACE_Registry::Naming_Context::name

(

)

Get name (String version)

name() [2/5]

void ACE_Registry::Naming_Context::name

(

ACE_TString &

name

)

Set name (String version)

name() [3/5]

void ACE_Registry::Naming_Context::name ( const ACE_TString & name )

protected

Set name (String version)

name() [4/5]

void ACE_Registry::Naming_Context::name ( const Name & name )

protected

Set name (Name version)

name() [5/5]

void ACE_Registry::Naming_Context::name

(

Name &

name

)

Get name (Name version)

new_context()

int ACE_Registry::Naming_Context::new_context

(

Naming_Context &

naming_context

)

Create new naming_context.

operator=()

const ACE_Registry::Naming_Context & ACE_Registry::Naming_Context::operator= ( const Naming_Context & rhs )

private

Disallow assignment.

parent() [1/2]

HKEY ACE_Registry::Naming_Context::parent

(

)

Get parent.

parent() [2/2]

void ACE_Registry::Naming_Context::parent ( HKEY parent )

protected

Set parent.

rebind() [1/2]

int ACE_Registry::Naming_Context::rebind	(	const ACE_TString &	name,
		const Object &	object )

Update <object> with name in this context.

rebind() [2/2]

int ACE_Registry::Naming_Context::rebind	(	const Name &	name,
		const Object &	object )

Update <object> with name in this context (Name version)

rebind_context() [1/2]

int ACE_Registry::Naming_Context::rebind_context	(	const ACE_TString &	name,
		Naming_Context &	naming_context )

Rename <naming_context> to name.

rebind_context() [2/2]

int ACE_Registry::Naming_Context::rebind_context	(	const Name &	name,
		Naming_Context &	naming_context )

Rename <naming_context> to name (Name version)

resolve() [1/2]

int ACE_Registry::Naming_Context::resolve	(	const ACE_TString &	name,
		Object &	object )

Find <object> with name in this context.

resolve() [2/2]

int ACE_Registry::Naming_Context::resolve	(	const Name &	name,
		Object &	object )

Find <object> with name in this context (Name version)

resolve_context() [1/2]

int ACE_Registry::Naming_Context::resolve_context	(	const ACE_TString &	name,
		Naming_Context &	naming_context,
		u_long	security_access = KEY_ALL_ACCESS )

Find <naming_context> with name in this context.

resolve_context() [2/2]

int ACE_Registry::Naming_Context::resolve_context	(	const Name &	name,
		Naming_Context &	naming_context,
		u_long	security_access = KEY_ALL_ACCESS )

Find <naming_context> with name in this context (Name version)

unbind() [1/2]

int ACE_Registry::Naming_Context::unbind

(

const ACE_TString &

name

)

Delete object with name in this context.

unbind() [2/2]

int ACE_Registry::Naming_Context::unbind

(

const Name &

name

)

Delete object with name in this context (Name version)

unbind_context() [1/2]

int ACE_Registry::Naming_Context::unbind_context

(

const ACE_TString &

name

)

Remove naming_context with name from this context.

unbind_context() [2/2]

int ACE_Registry::Naming_Context::unbind_context

(

const Name &

name

)

Remove naming_context with name from this context (Name version)

Friends And Related Symbol Documentation

ACE_Predefined_Naming_Contexts

friend class ACE_Predefined_Naming_Contexts

friend

Friend factory.

Member Data Documentation

key_

HKEY ACE_Registry::Naming_Context::key_

private

Key for self.

name_

ACE_TString ACE_Registry::Naming_Context::name_

private

Name of self.

parent_key_

HKEY ACE_Registry::Naming_Context::parent_key_

private

Key for parent.

---

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

• Registry.h
• Registry.cpp