INameService Interface Reference

---

Description

This internal interface extends the IToiNameService interface with a method for adding entries to the database.

See also:

IToiNameService

List of all members.

Public Member Functions
void	RegisterObject (in string objectName, in string address)
void	ReleaseObject (in string objectName)
void	RegisterObserverInternal (in string address) raises (TToiInvalidArgumentException)
void	ReleaseObserverInternal (in string address) raises (TToiInvalidArgumentException)

---

Member Function Documentation

void INameService::RegisterObject	(	in string	objectName,
		in string	address
	)

The RegisterObject method adds or replaces an entry in the name service database. Each entry in the database consists of an object name together with an IPC address that can be used to connect to the object.

Parameters:

objectName	The name of the object. This is the name used by clients when they query the name service for an address.
address	The IPC address to the object.

void INameService::RegisterObserverInternal

(

in string

address

)

raises (TToiInvalidArgumentException)

Registers an observer. Upon registration, the observer will receive one INameServiceObserver::OnObjectRegistered() notification for each of the already registered objects.

Parameters:

address

The IPC address to an object implementing INameServiceObserver.

Exceptions:

TToiInvalidArgumentException

Raised if the address is invalid.

void INameService::ReleaseObject

(

in string

objectName

)

The ReleaseObject method removes an entry in the name service database.

Parameters:

objectName

The name of the object to be removed.

void INameService::ReleaseObserverInternal

(

in string

address

)

raises (TToiInvalidArgumentException)

Unregisters an observer.

Parameters:

address

The IPC address to an object implementing INameServiceObserver.

Exceptions:

TToiInvalidArgumentException

Raised if the address is invalid.