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

4.10.1.7 COSNAMING-NAMINGCONTEXT-NEW-CONTEXT

名前

　COSNAMING-NAMINGCONTEXT-NEW-CONTEXT

形式

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

  DATA DIVISION.
    COPY CONST IN CORBA.
    01 COPY COSNAMING-NAMINGCONTEXT IN CORBA REPLACING COSNAMING-
　　　NAMINGCONTEXT BY NC.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY COSNAMING-NAMINGCONTEXT IN CORBA REPLACING COSNAMING-
　　　NAMINGCONTEXT BY NC-RET.

  PROCEDURE DIVISION.
    CALL "COSNAMING-NAMINGCONTEXT-NEW-CONTEXT" USING
         NC
         ENV
         NC-RET.

機能説明

　NCで指定されたネーミングコンテキストを管理するネーミングサーバ内に新しいネーミングコンテキストを作成し、作成されたネーミングコンテキストのオブジェクトリファレンスを返します。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASE関数を使用して領域を解放する必要があります。

復帰値

　正常終了した場合は、ネーミングコンテキストのオブジェクトリファレンスが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONが設定され、IDとMINORに詳細情報が設定されます。IDとMINORの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

• ネーミングコンテキストの作成、登録には、COSNAMING-NAMINGCONTEXT-BIND-NEW-CONTEXTを使用することを推奨します。
• 本メソッドを呼び出して作成したネーミングコンテキストは、必ずCOSNAMING-NAMINGCONTEXT-BIND-CONTEXTを発行してバインディングを作成／登録してください。