Contained::absolute_name

Overview The absolute_name operation retrieves the absolute ScopedName that identifies a Contained object within its enclosing Repository.
Original interface CORBA module: Contained Interface
Exceptions CORBA::SystemException


Intended Usage

The absolute_name attribute is an absolute ScopedName that identifies a Contained object uniquely within its enclosing Repository.

If the Container within which this object is defined is a Repository, the absolute name is formed by concatenating the string "::" and this object's name attribute. Otherwise, the absolute_name is formed by concatenating the absolute_name attribute of the object referenced by this object's defined_in attribute, the string "::", and this object's name attribute.

A read operation is provided to retrieve the absolute_name value for all Interface Repository objects that have a name attribute.

Syntax

  readonly attribute ScopedName absolute_name;

Input parameters

None

Return values

ScopedName
The returned value is a CORBA::ScopedName data type, the memory of which is owned by the caller. The caller can release this memory by invoking the CORBA::string_free function.

Example

  // C++
     // assume the interface_def_ptr has already been initialized
     CORBA::InterfaceDef * interface_def_ptr;
 
     // the following call returns the absolute name associated with the 
     // interface
     CORBA::ScopedName returned_absolute_name;
     returned_absolute_name = interface_def_ptr-> absolute_name();

Related reference
CORBA module



Searchable topic ID:   rcor_modct1
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modct1.html

Library | Support | Terms of Use | Feedback