BOA::create

Overview Maps ReferenceData to a local object, and prepares that object for export.
Original class CORBA module: BOA Class
Exceptions CORBA::SystemException


Intended Usage

Typical server applications need never use this method.

This method is part of the CORBA specification.

Syntax

  virtual CORBA::Object_ptr create
    (const CORBA::ReferenceData& refdata,
    CORBA::InterfaceDef_ptr intf,
    CORBA::ImplementationDef_ptr impldef);

Input parameters

refdata
The application-specific ReferenceData of an object residing in a server.
intf
The InterfaceDef object, retrieved from the Interface Repository, that describes the interface supported by the object described by the refdata parameter. Currently, this parameter is unused and can be NULL. The caller retains ownership of this object .
impldef
The ImplementationDef of the server in which the call is being made. Currently, this parameter is unused and can be NULL. The caller retains ownership of this object.

Return value

CORBA::Object_ptr
The local object in the server that corresponds to the input ReferenceData, after it has been prepared for export. Ownership of this object reference is transferred to the caller, and should be subsequently released using CORBA::release.

Example

  #include "corba.h"
  extern CORBA::BOA_ptr srvboa; /* assume previously initialized
                                   using CORBA::ORB::BOA_init */
  ...
  ::CORBA::ReferenceData * rd = (::CORBA::ReferenceData *) NULL;
  rd = srvboa->get_id(this);
  ::CORBA::Object_ptr objPtr =
                  srvboa->create(*rd,
                                 CORBA::InterfaceDef::_nil(),
                                 CORBA::ImplementationDef::_nil());
  ...

Related reference
CORBA module



Searchable topic ID:   rcor_modbo3
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_modbo3.html

Library | Support | Terms of Use | Feedback