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

1.1.6 CORBA_ORB_object_to_string()

名前

CORBA_ORB_object_to_string

形式

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

機能説明

objで指定したオブジェクトのオブジェクトリファレンスを文字列に変換します。

本関数は変換した文字列を格納する領域を獲得するため、この領域が不要になった時点で、CORBA_free()を使用して領域を解放する必要があります。

パラメタ

orb

CORBA_ORB_init()によって獲得したORBのオブジェクトリファレンス。

obj

文字列形式に変換する対象のオブジェクトリファレンス。

env

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

復帰値

正常終了した場合は、文字列が設定されます。
異常終了した場合は、NULLが復帰し、env構造体の_majorにはCORBA_SYSTEM_EXCEPTIONが設定され、_idと_minorに詳細情報が設定されます。

_idと_minorの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。