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

4.2.4 CORBA-ORB-RESOLVE-INITIAL-REFERENCES-REMOTE

名前

　CORBA-ORB-RESOLVE-INITIAL-REFERENCES-REMOTE

形式

DATA DIVISION.
  WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY ORB IN CORBA REPLACING CORBA-ORB BY ORB.
    01 COPY OBJECTID IN CORBA REPLACING CORBA-ORB-OBJECTID BY IDENTIFIER.
    01 COPY REMOTEMODIFIER IN CORBA REPLACING CORBA-ORB-REMOTEMODIFIER BY M.
    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-RESOLVE-INITIAL-REFERENCES-REMOTE" USING
         ORB
         IDENTIFIER
         M
         ENV
         OBJ.

機能説明

　IDENTIFIERで指定されたオブジェクトのオブジェクトリファレンスを返します。オブジェクトリファレンスは、URL形式でMに定義されたホストのinitial_servicesを検索して獲得します。

　IDENTIFIERに指定可能な代表的なものを以下に示します。

　CORBA-ORB-OBJECTID-LIGHTINTFR

　インタフェースリポジトリ（静的スケルトンインタフェース）

　CORBA-ORB-OBJECTID-INTFREP

　インタフェースリポジトリ（動的スケルトンインタフェース）

　CORBA-ORB-OBJECTID-IMPLREP

　インプリメンテーションリポジトリ

　CORBA-ORB-OBJECTID-NAMESERVICE

　ネーミングサービス

　Mには複数のURLを指定することが可能です。この場合、指定された順に検索を行い、オブジェクトリファレンスが見つかった時点で検索は打ち切られます。

　URLの指定形式を以下に示します。

　iiop//<address>[:<port>]

　<address>にはホスト名、DNS名、IPアドレスを指定することが可能です。省略はできません。
　<port>には接続先のORBのポート番号を指定します。
　なお、IPv6形式のアドレスを指定することはできません。

　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASEを使用して領域を解放する必要があります。

注意事項

　GS等、Interstage Application Server以外のORB製品に対して本関数を使用することはできません。

復帰値

　正常終了した場合は、CORBA-OBJECTのオブジェクトリファレンスが返されます。指定されたオブジェクトが存在しない場合は、NULLが返されます。
　異常終了した場合は、以下の例外が発生します。

　CORBA-ORB-INVALIDNAME

　IDENTIFIERに指定されたオブジェクトが見つかりません。

　CORBA-SYSTEM-EXCEPTION

　その他の要因。

　システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。