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

4.10.3.1 COSNAMING-NAMINGCONTEXTEXT-TO-STRING

名前

　COSNAMING-NAMINGCONTEXTEXT-TO-STRING

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION. 
   SPECIAL-NAMES. 
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA. 
     . 

  DATA DIVISION. 
    COPY CONST IN CORBA. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT    BY NCE. 
    01 COPY COSNAMING-NAME IN CORBA REPLACING COSNAMING-NAME BY N. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 COPY COSNAMING-NAMINGCONTEXTEXT-STR IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT-STR BY SN. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-TO-STRING" USING
         NCE
         N
         ENV
         SN.

機能説明

　Nで指定された構造体型のバインディング名を文字列表記のバインディング名に変換します。NCEはネーミングコンテキストのオブジェクトリファレンスです。
　本関数は復帰値を格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

　正常終了した場合は、文字列表記のバインディング名が返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
　ユーザ例外の場合は、以下の詳細情報が設定されます。

　IDL:CosNaming/NamingContext/InvalidName:1.0

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

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