この関数を使用して、指定したメッセージに関連付けられているルート構文エレメントを取得します。 これは、message パラメーターによって識別されるメッセージ・オブジェクトに関連付けられている (およびこれが所有する) ルート・エレメントを戻します。 ブローカーによってメッセージ・オブジェクトが構成されると、 ルート・エレメントが自動的に作成されます。
CciElement* cniRootElement(
int* returnCode,
CciMessage* message);
成功した場合、ルート・エレメント・オブジェクトのアドレスが戻されます。 失敗した場合、ゼロ (CCI_NULL_ADDR) が戻され、returnCode パラメーターがエラーの理由を示します。
inRootElement = cniRootElement(&rc, message);