CORBA ブートストラップ処理のプログラミング・リファレンス

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo CORBA プログラミング・リファレンス > CORBA ブートストラップ処理のプログラミング・リファレンス

Tuxedo CORBA プログラミング・リファレンス

Tobj_Bootstrap::register_callback_port

概要

IIOP ハンドラ (ISH) で共同クライアント/サーバの受信ポートを登録します。

C++ マッピング

void register_callback_port(CORBA::Object_ptr objref);

パラメータ

objref

共同クライアント/サーバによって作成されたオブジェクト・リファレンス。

例外

BAD_PARAM

オブジェクトがニルである場合、またはオブジェクトに格納されているホストが接続と一致しない場合に発生します。

IMP_LIMIT

register_callback_port メソッドが複数回呼び出された場合に発生します。

説明

この C++ メンバ関数 (または Java メソッド) は、共同クライアント/サーバの受信ポートを ISH に通知するために呼び出します。このメソッドは、GIOP 1.2 の双方向機能をサポートしていない共同クライアント/サーバ ORB (つまり GIOP 1.0 および 1.1 のクライアント ORB) でのみ使用します。GIOP 1.0 および 1.1 の場合、ISH では共同クライアント/サーバごとに 1 つの受信ポートのみをサポートします。このため、register_callback_port メソッドは接続されている共同クライアント/サーバごとに 1 度だけ呼び出すようにします。

使用上の注意

このメソッドを使用するときには、以下の情報を考慮に入れてください。

register_callback_port メソッドが共同クライアント/サーバから呼び出されない場合、コールバック・ポートは ISH に登録されず、デフォルトで非対称アウトバウンド IIOP が使用されます。この場合は、-O オプションを使用してサーバの IIOP リスナ (ISL) を起動する必要があります。-O オプションは、非対称アウトバウンド IIOP を有効にします。非対称アウトバウンド IIOP を有効にしないと、サーバからクライアントの呼び出しが ISL/ISH によって許可されません。
POA の代わりに BEAWrapper Callbacks API を使用し、かつ双方向の振る舞いを使用する必要がある場合は、GIOP 1.2 をサポートする ISH を使用する場合でも常に register_callback_port メソッドを呼び出す必要があります。
コールバック・オブジェクトの双方向機能を使用する必要がある場合は、register_callback_port メソッドを呼び出してからコールバック・オブジェクトのオブジェクト・リファレンスをサーバに渡す必要があります。

戻り値

特にありません。