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

4.6.2 CORBA-CONTEXT-SET-ONE-VALUE

名前

CORBA-CONTEXT-SET-ONE-VALUE

形式

 ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
 DATA DIVISION.
  WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY CONTEXT IN CORBA REPLACING CORBA-CONTEXT BY CTX.
    01 PROP-NAME USAGE POINTER.
    01 C-VALUE USAGE POINTER.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY STATUS IN CORBA REPLACING CORBA-STATUS BY ORB-STATUS.

 PROCEDURE DIVISION.
    CALL "CORBA-CONTEXT-SET-ONE-VALUE" USING
        CTX
        PROP-NAME
        C-VALUE
        ENV
        ORB-STATUS.

機能説明

アプリケーションは、CORBA-ORB-GET-DEFAULT-CONTEXT関数またはCORBA-CONTEXT-CREATE-CHILD関数で獲得したコンテキストオブジェクトのオブジェクトリファレンスをCTXに指定することにより、PROP-NAMEで指定した1つの属性値をコンテキストオブジェクトに設定することができます。

復帰値

正常終了した場合は、CORBA-OKが返されます。
異常終了した場合は、CORBA-FAILEDが返されます。
CTXにNULLが指定された場合、ENV構造体のMAJORにはCORBA-USER-EXCEPTIONが設定されます。