Object::_non_existent

Overview Determines whether an object reference regers to a valid object.
Original class CORBA::Object


Intended Usage

This method is intended to be used to determine whether an object reference (either a proxy object or a local pointer) refers to a valid object. When invoked on a proxy object, this results in a remote call to the server, which may activate the remote object to determine its existence, but no method is invoked on the remote object itself (unless the server invokes some method on the object as part of activation).

Syntax

  virtual Boolean _non_existent () = 0;

Input parameters

None.

Return values

CORBA::Boolean
A zero return value indicates that the target object reference refers to a valid object. A nonzero return value indicates that the target object reference refers to a non-existent object.

Example

  /* Assume the following IDL interface */
  interface testObject
  {
    string testMethod (in long input_value, out float out_value);
  };
  /* Here is the cpp code */
  testObject_ptr test_obj;
  /* instantiate test_obj and make it a proxy somehow */
  ...
  CORBA::Boolean retval = test_obj->_non_existent();
  ...

Related reference
CORBA module



Searchable topic ID:   rcor_modob0
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_modob0.html

Library | Support | Terms of Use | Feedback