名前
CORBA::ORB::resolve_initial_references
形式
#include <orb_cplus.h> Object_ptr CORBA::ORB::resolve_initial_references ( ObjectId identifier, CORBA::Environment& env );
機能説明
identifierで指定されたオブジェクトのオブジェクトリファレンスを返します。
オブジェクトリファレンスは、“アプリケーション作成ガイド(CORBAサービス編)”の“ネーミングサービスのイニシャルリファレンスの獲得”に基づいて返されます。
代表的なidentifierを以下に示します。
インタフェースリポジトリ(静的スケルトンインタフェース)
インタフェースリポジトリ(動的スケルトンインタフェース)
インプリメンテーションリポジトリ
ネーミングサービス
本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA::release()を使用して領域を解放する必要があります。
パラメタ
イニシャルリファレンスの識別子。
例外情報が格納される構造体。
復帰値
正常終了した場合、オブジェクトリファレンスが設定されます。
NULLが返された場合、指定されたオブジェクトが存在しません。
異常終了した場合、envのexceptionメンバにSystemExceptionオブジェクトのオブジェクトリファレンスが設定されます。
設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。