cniGetAttribute

特定のノード・インスタンスの属性の値を取得します。 これは、ノード属性の値を検索するレポート要求を受け取る際に、 メッセージ・ブローカーによって呼び出されます。 ブローカーは、この属性名がノードに有効であることを確認します。

この時点でノードは、以下の処理を担当します。
  1. 属性値の文字表現を戻します。
  2. データが機密であり、レポートに表示できない場合には、ヌル・ストリングを戻します。
  3. エラーの発生時に例外をスローします。
定義されている場所 タイプ メンバー
CNI_VFT オプション iFpGetAttribute

構文

int cniGetAttribute(
    CciContext* context,
    CciChar*     attrName,
    CciChar*    buffer,
  int          bufsize);

パラメーター

context
ノードによって作成され、cniCreateNodeContext 関数によって戻される、 ノードのインスタンスのコンテキストのアドレス (入力)。
attrName
値が検索される属性の名前 (入力)。
buffer
属性値のコピー先のバッファーのアドレス (出力)。
bufsize
buffer パラメーターで指定した、バイト単位のバッファーの長さ (入力)。

戻り値

正常に実行されると、ゼロが戻され、 指定したバッファーに属性の値の文字表現が戻されます。 属性の名前が、ノードによってサポートされる名前を識別しない場合には、 非ゼロ値が戻されます。

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

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

関連資料
C 言語ノード・インプリメンテーション関数
cniCreateNodeContext
cniGetAttributeName