[Enterprise Extensions only]

Object::_get_interface

Overview Returns a reference to the CORBA::InterfaceDef describing the most specific interface supported by the target object.
Original class CORBA::Object
Exceptions CORBA::SystemException


Intended Usage

This method is intended to be used to obtain the CORBA::InterfaceDef object describing the most specific interface of the target object. When invoked on a proxy object, this method is forwarded to the remote object, and a proxy to a remote CORBA::InterfaceDef object (residing in the same server as the remote object) is returned. This InterfaceDef describes the interface of the remote object, which may be more specific than the interface of the proxy on which CORBA::_get_interface was invoked. (This can occur when the client does not have bindings for the most specific interface supported by the remote object.)

When invoked on a local object, a local CORBA::InterfaceDef object is retrieved from the local Interface Repository.

IDL Syntax

  virtual CORBA::InterfaceDef_ptr _get_interface () = 0;

Input parameters

None.

Return values

CORBA::InterfaceDef_ptr
A pointer to the InterfaceDef object that describes the most specific interface supported by the target object . The caller assumes ownership of this object.

Example

See the CORBA::Object::_get_implementation.