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

4.10.3.4 COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR

名前

　COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR

形式

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 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ. 

  PROCEDURE DIVISION. 
    CALL "COSNAMING-NAMINGCONTEXTEXT-RESOLVE-STR" USING
         NCE
         SN
         ENV
         OBJ.

機能説明

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

復帰値

　正常終了した場合は、オブジェクトリファレンスが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
　ユーザ例外の場合は、以下の詳細情報が設定されます。

　IDL:CosNaming/NamingContext/NotFound:1.0

　Nで指定された名前が見つかりません。

　IDL:CosNaming/NamingContext/CannotProceed:1.0

　NCで指定されたネーミングコンテキストが存在しません。

　IDL:CosNaming/NamingContext/InvalidName:1.0

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

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