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 最終更新: 08/21/2006
as07460_