cniRootElement

指定したメッセージに関連付けられているルート構文エレメントを取得します。 これは、message パラメーターによって識別されるメッセージ・オブジェクトに関連付けられている (およびこれが所有する) ルート・エレメントを戻します。 ブローカーによってメッセージ・オブジェクトが構成されると、 ルート・エレメントが自動的に作成されます。

構文

CciElement* cniRootElement(
    int*                        returnCode,
  CciMessage*  message);

パラメーター

returnCode
関数からの戻りコード (出力)。
message
メッセージ・オブジェクトのアドレス (入力)。

戻り値

成功した場合、ルート・エレメント・オブジェクトのアドレスが戻されます。 失敗した場合、ゼロ (CCI_NULL_ADDR) が戻され、returnCode パラメーターがエラーの理由を示します。

   inRootElement = cniRootElement(&rc, message);

関連概念
ユーザー定義のメッセージ処理ノード
ユーザー定義の出力ノード

関連タスク
C でのメッセージ処理ノードの作成

関連資料
C 言語ノード・ユーティリティー関数
cniFirstChild
cniLastChild
cniNextSibling
cniParent
cniPreviousSibling
cniSearchElement グループ