概要

POA およびすべての下位 POA を破棄します。

C++ バインディング

void destroy (
              CORBA::Boolean etherealize_objects,
               CORBA::Boolean wait_for_completion)

引数

説明

このオペレーションは、POA およびすべての下位 POA を破棄します。POA とその名前は、同じプロセスで後から再作成できます。ただし、POAManager::deactivate オペレーションで同じプロセスによる関連付けられた POA の再作成を無効にしている場合は除きます。

POA が破棄された場合、実行を開始した要求については、完了するまで処理が続行されます。実行を開始していない要求については、それが新しく受け取られ、POA がないような状態で処理されます。そのため、要求は拒否され、OBJECT_NON_EXIST 例外が発生します。

wait_for_completion パラメータが TRUE の場合、プロセス内の要求がすべて完了し、etherealize の呼び出しがすべて完了した後にのみ、destroy オペレーションは戻り値を返します。それ以外の場合、destroy オペレーションは POA の破棄後に戻り値を返します。

注記 このリリースの BEA Tuxedo では、マルチスレッドをサポートしていません。そのため、オブジェクト呼び出しのコンテキストで呼び出しを行う場合、wait_for_completion は TRUE に指定しないでください。この指定を行うと、POA はそれが実行中のときに自身を解放できなくなります。

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

戻り値

特にありません。