概要

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

C++ バインディング

CORBA::Object_ptr create_reference (
                       const char * intf)

引数

例外

このオペレーションには、値 SYSTEM_ID を持つ LifespanPolicy が必要です。この LifespanPolicy がない場合、PortableServer::WrongPolicy 例外が発生します。

説明

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

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

戻り値

オブジェクトへのポインタを返します。