パーサー・オブジェクトに関連付けられたユーザー定義拡張機能コンテキストを作成します。 これは、パーサー・オブジェクトのインスタンスが構成されるか、または割り振られる際に、メッセージ・ブローカーによって呼び出されます。 これは、メッセージ・フローによってメッセージ・データが解析されるときに発生します。 ブローカーがパーサー・オブジェクトを構成するかまたは割り振り、メッセージ・データの適切なセクションを獲得します。この関数が呼び出される前に、ブローカーは、パーサー用の有効なルート・エレメントとして名前エレメントを作成しています。 ただし、このエレメントには名前が付いていません。 パーサーは、このエレメントに cpiSetElementName 関数で名前を指定しなければなりません。
定義されている場所 | タイプ | メンバー |
CPI_VFT | 必須 | iFpCreateContext |
void cpiCreateContext( CciParser* parser);
成功した場合、ユーザー定義拡張機能コンテキストのアドレスが戻されます。 失敗した場合、ゼロの値が戻されます。