ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
FUJITSU Software

1.1.3 CORBA_ORB_resolve_initial_references()

名前

CORBA_ORB_resolve_initial_references

形式

#include <orb.h>
CORBA_Object  CORBA_ORB_resolve_initial_references(
        CORBA_ORB  orb,
        CORBA_ORB_ObjectId  identifier,
        CORBA_Environment *env );

機能説明

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

代表的なidentifierを以下に示します。

CORBA_ORB_ObjectId_LightInterfaceRepository

インタフェースリポジトリ(静的スケルトンンインタフェース)

CORBA_ORB_ObjectId_InterfaceRepository

インタフェースリポジトリ(動的スケルトンンインタフェース)

CORBA_ORB_ObjectId_ImplementationRepository

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

CORBA_ORB_ObjectId_NameService

ネーミングサービス

LBO_ObjectId_LoadBalancingOption

ロードバランス

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

パラメタ

orb

CORBA_ORB_init()によって獲得したORBのオブジェクトリファレンス。

identifier

イニシャルリファレンスの識別子。

env

例外情報が格納される構造体。

復帰値

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



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


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


異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが設定され、_idと_minorに詳細情報が設定されます。

_idと_minorの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

備考

CORBA_ORB_init()の引数をカスタマイズすることによってクライアント固有のイニシャルサービスのオブジェクトリファレンスを獲得することが可能となります。詳細は“アプリケーション作成ガイド(CORBAサービス編)”の“ネーミングサービスのイニシャルリファレンスの獲得”を参照してください。