[Enterprise Extensions only]

Contained::name

Overview The name operations are used to read and write the name attribute of an Interface Repository object.
Original interface CORBA module: Contained Interface
Exceptions CORBA::SystemException


Intended Usage

An object that is contained by another object has a name attribute that identifies it uniquely within the enclosing Container object. Both Read and Write operations are supported, with parameters listed.

IDL Syntax

  attribute identifier name;

Read operations

Input parameters
none
Return values
CORBA::Identifier

This operation returns a copy of the name of the object, that is owned by the caller. The caller may later free this memory by invoking CORBA::string_free.

Write operations

Input parameters
CORBA::Identifier name

A name that identifies the new name for the Interface Repository object.

Return values
none

Example

  // C++
     // assume 'interface_1' has already been created
     CORBA::InterfaceDef * interface_1;
 
     // establish a new name for the interface
     interface_1-> name ("interface_409");
 
     // retrieve the interface name
     CORBA::Identifier retrieved_name;
     retrieved_name = interface_1-> name ();