Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

ACE_Registry::Naming_Context Class Reference

An context representation. More...

#include <Registry.h>

Collaboration diagram for ACE_Registry::Naming_Context:

Collaboration graph
[legend]
List of all members.

Public Types

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

Public Methods

 Naming_Context (void)
 Empty constructor: keys will be NULL.

 Naming_Context (const HKEY &key)
 Constructor: key_ will be set to <key>.

 ~Naming_Context (void)
 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 (void)
 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 (void)
 Sync content of context to disk.

int close (void)
HKEY key (void)
 Get key.

HKEY parent (void)
 Get parent.

void name (Name &name)
void name (ACE_TString &name)
 Set name (String version).

ACE_TString name (void)
 Get name (String version).


Protected Methods

void key (HKEY key)
 Set key.

void parent (HKEY parent)
 Set parent.

void name (const Name &name)
void name (const ACE_TString &name)

Private Methods

 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
 

Enumeration values:
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

ACE_Registry::Naming_Context::Naming_Context void   
 

Empty constructor: keys will be NULL.

ACE_Registry::Naming_Context::Naming_Context const HKEY &    key
 

Constructor: key_ will be set to <key>.

ACE_Registry::Naming_Context::~Naming_Context void   
 

Destructor will call <Naming_Context::close>.

ACE_Registry::Naming_Context::Naming_Context const Naming_Context &    rhs [private]
 

Disallow copy constructors.


Member Function Documentation

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)

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)

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

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)

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)

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)

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

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)

int ACE_Registry::Naming_Context::close void   
 

Close the handle of the context Note: <close> does not call <flush>

int ACE_Registry::Naming_Context::destroy void   
 

Same as <unbind_context> with <this> as naming_context.

int ACE_Registry::Naming_Context::flush void   
 

Sync content of context to disk.

void ACE_Registry::Naming_Context::key HKEY    key [protected]
 

Set key.

HKEY ACE_Registry::Naming_Context::key void   
 

Get key.

int ACE_Registry::Naming_Context::list Binding_List   list
 

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

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

void ACE_Registry::Naming_Context::name const ACE_TString   name [protected]
 

Set name (String version)

void ACE_Registry::Naming_Context::name const Name   name [protected]
 

Set name (Name version)

ACE_TString ACE_Registry::Naming_Context::name void   
 

Get name (String version).

void ACE_Registry::Naming_Context::name ACE_TString   name
 

Set name (String version).

void ACE_Registry::Naming_Context::name Name   name
 

Get name (Name version)

int ACE_Registry::Naming_Context::new_context Naming_Context &    naming_context
 

Create new <naming_context>.

const ACE_Registry::Naming_Context & ACE_Registry::Naming_Context::operator= const Naming_Context &    rhs [private]
 

Disallow assignment.

void ACE_Registry::Naming_Context::parent HKEY    parent [protected]
 

Set parent.

HKEY ACE_Registry::Naming_Context::parent void   
 

Get parent.

int ACE_Registry::Naming_Context::rebind const ACE_TString   name,
const Object   object
 

Update <object> with <name> in <this> context.

int ACE_Registry::Naming_Context::rebind const Name   name,
const Object   object
 

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

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

Rename <naming_context> to <name>.

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

Rename <naming_context> to <name> (Name version)

int ACE_Registry::Naming_Context::resolve const ACE_TString   name,
Object   object
 

Find <object> with <name> in <this> context.

int ACE_Registry::Naming_Context::resolve const Name   name,
Object   object
 

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

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.

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)

int ACE_Registry::Naming_Context::unbind const ACE_TString   name
 

Delete object with <name> in <this> context.

int ACE_Registry::Naming_Context::unbind const Name   name
 

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

int ACE_Registry::Naming_Context::unbind_context const ACE_TString   name
 

Remove naming_context with <name> from <this> context.

int ACE_Registry::Naming_Context::unbind_context const Name   name
 

Remove naming_context with <name> from <this> context (Name version)


Friends And Related Function Documentation

friend class ACE_Predefined_Naming_Contexts [friend]
 

Friend factory.


Member Data Documentation

HKEY ACE_Registry::Naming_Context::key_ [private]
 

Key for self.

ACE_TString ACE_Registry::Naming_Context::name_ [private]
 

Name of self.

HKEY ACE_Registry::Naming_Context::parent_key_ [private]
 

Key for parent.


The documentation for this class was generated from the following files:
Generated on Wed Jan 14 22:47:09 2004 for ACE by doxygen1.2.18