ACE_Registry_Name_Space(3)

NAME

ACE_Registry_Name_Space - Interface to a Name Server Database which is maintained by the Win32 Registry. Allows to add, change, remove and resolve NameBindings.

SYNOPSIS

#include <ACE/Registry_Name_Space.h>
class ACE_Registry_Name_Space : public ACE_Name_Space
{
  public:
    ACE_Registry_Name_Space (void);
    ACE_Registry_Name_Space (ACE_Name_Options *name_options);
    ~ACE_Registry_Name_Space (void);
    int open (ACE_Name_Options *name_options);
    int bind (
        const ACE_WString &name_in,
        const ACE_WString &value_in,
        const char *type_in = ""
        );
    int rebind (
        const ACE_WString &name_in,
        const ACE_WString &value_in,
        const char *type_in = ""
        );
    int unbind (const ACE_WString &name_in);
    int resolve (
        const ACE_WString &name_in,
        ACE_WString &value_out,
        char *&type_out
        );
    int list_names (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        );
    int list_values (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        );
    int list_types (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        );
    int list_name_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        );
    int list_value_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        );
    int list_type_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        );
    void dump (void) const;
  private:
    ACE_Registry::Naming_Context context_;
};

DESCRIPTION

Manages a Naming Service for a registry name space which includes bindings for all contexts. All strings are stored in wide character format. A Name Binding consists of a name (that's the key), a value string. There is no type string support in this Name Space.

PUBLIC MEMBERS

ACE_Registry_Name_Space (void);

Constructor

ACE_Registry_Name_Space (ACE_Name_Options *name_options);

Contacts and opens the registry on the specified server

~ACE_Registry_Name_Space (void);

Destructor

int open (ACE_Name_Options *name_options);

Contacts and opens the registry on the specified server

int bind (
    const ACE_WString &name_in,
    const ACE_WString &value_in,
    const char *type_in = ""
    );

Bind a new name to a naming context (Wide character strings).

int rebind (
    const ACE_WString &name_in,
    const ACE_WString &value_in,
    const char *type_in = ""
    );

Overwrite the value or type of an existing name in a ACE_Name_Space or bind a new name to the context, if it didn't exist yet. (Wide charcter strings interface).

int unbind (const ACE_WString &name_in);

Delete a name from a ACE_Name_Space (Wide charcter strings Interface).

int resolve (
    const ACE_WString &name_in,
    ACE_WString &value_out,
    char *&type_out
    );

Get value and type of a given name binding (Wide chars). The caller is responsible for deleting both value_out and type_out!

int list_names (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    );

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string.

int list_values (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    );

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string.

int list_types (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    );

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string.

int list_name_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    );

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string. Returns the complete binding associated each pattern match.

int list_value_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    );

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string. Returns the complete binding associated each pattern match.

int list_type_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    );

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string. Returns the complete binding associated each pattern match.

void dump (void) const;

Dump the state of the object

PRIVATE MEMBERS

ACE_Registry::Naming_Context context_;

current context

AUTHOR

Irfan Pyarali ([email protected])

LIBRARY

ACE