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

2.2.7 CORBA::ORB::string_to_object()

名前

　CORBA::ORB::string_to_object

形式

　#include <orb_cplus.h>
　Object_ptr  CORBA::ORB::string_to_object(
　        const char *str,
　        CORBA::Environment& env );

機能説明

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

復帰値

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

　IDL:CORBA/BAD_PARAM:1.0

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