Interstage Application Server リファレンスマニュアル（API編）

2.13.2.8 CosNaming::NamingContext::bind_new_context()

名前

　CosNaming::NamingContext::bind_new_context

形式

　#include <orb_cplus.h>
　#include <CosNaming_cplus.h>
　CosNaming::NamingContext_ptr CosNaming::NamingContext::bind_new_context(
        CosNaming_Name n,
        CORBA_Environment *env);

機能説明

　新しいネーミングコンテキストを作成し、そのオブジェクトリファレンスとnで指定された名前のバインディングを作成して、既存のネーミングコンテキストに登録します。呼び出し元には、新しいネーミングコンテキストのオブジェクトリファレンスを返します。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。また、新しいネーミングコンテキストは、名前の登録が行われたネーミングコンテキストを管理するネーミングサーバ内に作成されます。

パラメタ

　n

　新しいネーミングコンテキストのオブジェクトリファレンスとバインドする名前。

　env

　例外情報が格納される構造体。

復帰値

　正常終了した場合は、ネーミングコンテキストのオブジェクトリファレンスが返され、envのexceptionメンバにNULLオブジェクトリファレンスが設定されます。
　異常終了した場合は、envのexceptionメンバにSystemExceptionオブジェクト、またはUserExceptionオブジェクトのオブジェクトリファレンスが設定されます。
　ユーザ例外の場合は、以下の例外が発生します。

　CosNaming::NamingContext::NotFound

　nで指定したネーミングコンテキストが見つかりません。

　CosNaming::NamingContext::CannotProceed

　ネーミングコンテキストが存在しません。

　CosNaming::NamingContext::InvalidName

　名前の指定に誤りがあります。

　CosNaming::NamingContext::AlreadyBound

　指定された名前のバインディングがすでに存在します。

　システム例外の場合は、設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。