Interstage Application Server リファレンスマニュアル（API編）

4.2.7 CORBA-ORB-STRING-TO-OBJECT

名前

　CORBA-ORB-STRING-TO-OBJECT

形式

   ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
   DATA DIVISION.
   WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY ORB IN CORBA REPLACING CORBA-ORB BY ORB.
    01 STR USAGE POINTER.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.

   PROCEDURE DIVISION.
     CALL "CORBA-ORB-STRING-TO-OBJECT" USING
          ORB
          STR
          ENV
          OBJ.

機能説明

　STRで指定した文字列をオブジェクトリファレンスに変換します。“アプリケーション作成ガイド（CORBAサービス編）”の“corbaloc URLスキーマ”に記述されているすべての形式の文字列を変換することができます。ただし、文字列に日本語を含むことはできません。
　ORBには、CORBA-ORB-INIT関数で返されるORBのオブジェクトリファレンスを指定します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASEを使用して領域を解放する必要があります。

復帰値

　正常終了した場合は、オブジェクトリファレンスが設定されます。
　異常終了した場合は、ENV構造体のMAJORにはCORBA-SYSTEM-EXCEPTIONが設定され、IDとMINORに詳細情報が設定されます。IDの意味と値は次のとおりです。

　IDL:CORBA/BAD_PARAM:1.0

　指定されたURLスキーマの形式に誤りがあります

　MINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
　ORBにNULLが指定された場合、ENV構造体のMAJORにはCORBA-USER-EXCEPTIONが設定されます。