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

4.10.3.2 COSNAMING-NAMINGCONTEXTEXT-TO-NAME

名前

　COSNAMING-NAMINGCONTEXTEXT-TO-NAME

形式

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-NAMINGCONTEXTEXT-STR IN CORBA REPLACING COSNAMING-
      NAMINGCONTEXTEXT-STR BY SN. 
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV. 
    01 N USAGE POINTER. 

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

機能説明

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

復帰値

　正常終了した場合、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合、CORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。IDの値と意味は次のとおりです。
IDL:CosNaming/NamingContext/InvalidName:1.0
　名前の指定に誤りがあります。