4.2.6 CORBA-ORB-OBJECT-TO-STRING

名前

CORBA-ORB-OBJECT-TO-STRING

形式

 ENVIRONMENT DIVISION.
 CONFIGURATION SECTION.
 SPECIAL-NAMES.
   SYMBOLIC CONSTANT
   COPY SYMBOL-CONST IN CORBA.
   .

DATA DIVISION.
    COPY CONST IN CORBA.
    01 COPY ORB IN CORBA REPLACING CORBA-ORB BY ORB.
    01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 O-STRING USAGE POINTER.

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

機能説明

  OBJで指定したオブジェクトのオブジェクトリファレンスを文字列に変換します。
  ORBには、CORBA-ORB-INIT関数で返されるORBのオブジェクトリファレンスを指定します。
  本関数は変換した文字列を格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

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