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

1.1.7 CORBA_ORB_string_to_object()

名前

　CORBA_ORB_string_to_object

形式

　#include <orb.h>
　CORBA_Object  CORBA_ORB_string_to_object(
        CORBA_ORB  orb,
        CORBA_string  str,
        CORBA_Environment  *env );

機能説明

　strで指定した文字列をオブジェクトリファレンスに変換します。“アプリケーション作成ガイド（CORBAサービス編）”の“corbaloc URLスキーマ”に記述されているすべての形式の文字列を変換することができます。ただし、文字列に日本語を含むことはできません。
　orbには、CORBA_ORB_init()で返されるORBのオブジェクトリファレンスを指定します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA_Object_release()を使用して領域を解放する必要があります。

復帰値

　正常終了した場合は、オブジェクトリファレンスが設定されます。
　異常終了した場合は、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが設定され、_idと_minorに詳細情報が設定されます。_idの意味と値は次のとおりです。
　_minorの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

　IDL:CORBA/BAD_PARAM:1.0

　指定されたURLスキーマの形式に誤りがあります。