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

1.9.3.2 CosNaming_NamingContextExt_to_name()

名前

　CosNaming_NamingContextExt_to_name

形式

　#include <orb.h>
　#include <CosNaming.h>
　CosNaming_Name  *CosNaming_NamingContextExt_to_name(
        CosNaming_NamingContextExt  nce,
        CosNaming_NamingContextExt_StringName  sn,
        CORBA_Environment  *env ) ;

機能説明

　snで指定された文字列表記のバインディング名を構造体型のバインディング名に変換します。
　本関数は復帰値を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

　nce

　ネーミングコンテキストのオブジェクトリファレンス。

　sn

　文字列表記のバインディング名。

　env

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

復帰値

　正常終了した場合は、構造体型のバインディング名が返され、env構造体の_majorにCORBA_NO_EXCEPTIONが設定されます。
　異常終了した場合は、env構造体の_majorにCORBA_SYSTEM_EXCEPTIONまたはCORBA_USER_EXCEPTIONが設定され、env構造体の_idに詳細情報が設定されます。
　ユーザ例外の場合は、以下の詳細情報が設定されます。

　IDL:CosNaming/NamingContext/InvalidName:1.0

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

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