概要

指定の ObjectId とインターフェイス・リポジトリ ID 値をカプセル化するオブジェクト・リファレンスを作成します。

C++ バインディング

CORBA::Object_ptr create_reference_with_id (
             const ObjectId & oid,
              const char * intf)

引数

例外

POA に SYSTEM_ID 値を持つ LifespanPolicy があり、ObjectId がシステムまたは POA によって生成されなかったことをその POA が検出した場合、BAD_PARAM システム例外が発生します。

説明

create_reference オペレーションは、指定の ObjectId とインターフェイス・リポジトリ ID 値をカプセル化するオブジェクト・リファレンスを作成します。このオペレーションは、POA に関連付けられた情報およびオペレーションのパラメータからリファレンスを構成するために必要な情報を収集します。このオペレーションは、リファレンスを作成するだけで、リファレンスと活性化されたサーバントとを関連付けるわけではありません。作成したリファレンスは、クライアントに渡されます。これにより、そのリファレンスの以降の要求で、指定の ObjectId を持つ同じPOA に呼び出しを返すことができます。

注記 この関数がサポートされるのは、共同クライアント/サーバのみです。

戻り値

Object_ptr を返します。

例

PortableServer::ObjectId_var oid =
	PortableServer::string_to_ObjectId("myLittleFoo");
CORBA::Object_var obj = poa->create_reference_with_id(
		oid.in(), "IDL:Foo:1.0");
Foo_var foo = Foo::_narrow(obj);