cniGetAttribute

制約事項: この関数は、属性値の長さを制限します。 この関数は、後方互換性のみのために提供されています。 cniGetAttribute2 をインプリメントする必要があります。

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

この時点でノードは、以下の処理を担当します。
  1. 属性値の文字表現を戻します。
  2. エラーの発生時に例外をスローします。
cniGetAttribute および cniGetAttribute2 の両方をインプリメントすると、cniDefineNodeClass は CCI_INV_IMPL_FUNCTION で失敗します。
定義されている場所 タイプ メンバー
CNI_VFT オプション iFpGetAttribute

構文

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

パラメーター

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

戻り値

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

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 Last updated: 5 01, 2006
as07460_