cniRootElement

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

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
メッセージ・オブジェクトのアドレス (入力)。

戻り値

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

   inRootElement = cniRootElement(&rc, message);
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as07680_