[Enterprise Extensions only]

ORB::create_environment

Overview Creates an Environment object.
Original class CORBA::ORB
Exceptions CORBA::SystemException


Intended Usage

This method is intended to be used to create an Environment object.

IDL Syntax

  CORBA::Status create_environment (CORBA::Environment_ptr& envptr);

Input parameters

envptr
A pointer for a CORBA::Environment object, passed by reference, to be initialized by the CORBA::ORB::create_environment method. The caller assumes ownership of the new Environment object.

Return values

CORBA::Status
A zero return value indicates success.

Example

  #include "corba.h"
  int main(int argc, char* argv[])
  {
    /* assume cop initialized */
    extern CORBA::ORB_ptr cop;
    CORBA::Environment_ptr envptr = CORBA::Environment::_nil();
    CORBA::Status status = cop->create_environment(envptr);
    return status;
  }