4.2.3 CORBA-ORB-RESOLVE-INITIAL-REFERENCES

名前

CORBA-ORB-RESOLVE-INITIAL-REFERENCES

形式

 DATA DIVISION.
 WORKING-STORAGE SECTION.
 COPY CONST IN CORBA.
 01 COPY REPOSITORYID IN CORBA REPLACING CORBA-REPOSITORYID  BY REPOSITORY-ID.
 01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
 01 COPY ORB IN CORBA REPLACING CORBA-ORB BY ORB.
 01 IDENTIFIER USAGE POINTER.

 PROCEDURE DIVISION.
   CALL "CORBA-ORB-RESOLVE-INITIAL-REFERENCES" USING
        ORB
        IDENTIFIER
        ENV
        REPOSITORY-ID.

機能説明

IDENTIFIERで指定されたオブジェクトを示すIDに対応したオブジェクトリファレンスを返します。
オブジェクトリファレンスは、“アプリケーション作成ガイド（CORBAサービス編）”の“ネーミングサービスのイニシャルリファレンスの獲得”に基づいて返されます。

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

CORBA-ORB-OBJECTID-LIGHTINTFR: インタフェースリポジトリ（静的スケルトンインタフェース）

CORBA-ORB-OBJECTID-INTFREP: インタフェースリポジトリ（動的スケルトンインタフェース）

CORBA-ORB-OBJECTID-IMPLREP: インプリメンテーションリポジトリ

CORBA-ORB-OBJECTID-NAMESERVICE: ネーミングサービス

LBO-OBJECTID: ロードバランス

ORBには、CORBA-ORB-INIT関数で返されるORBのオブジェクトリファレンスを指定します。IDENTIFIERには、CORBA-STRING-SET関数でIDを設定します。

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

復帰値

正常終了した場合は、オブジェクトリファレンスが設定されます。

指定されたオブジェクトが存在しない場合は、NULLが返されます。IDENTIFIERに“LBO-OBJECTID”を指定して、NULLが返された場合は、ロードバランス機能の環境が設定されていません。

指定されたオブジェクトが存在しない場合は、NULLが返されます。

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