WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

cniGetAttribute2

この関数を使用して、特定のノード・インスタンスの属性の値を取得します。 これは、ユーザーがデプロイするすべての属性が設定された後に、ブローカーにより呼び出されます。

実行グループ・プロセスが停止および開始された後にノードが正しく構成されるようにするため、結果はブローカーの持続構成データに書き込まれます。

ノードは、以下の処理を担当します。
  1. 属性値の文字表現を戻します。
  2. エラーの発生時に例外をスローします。

cniGetAttribute および cniGetAttribute2 関数の両方をインプリメントすると、cniDefineNodeClass は戻りコード CCI_INV_IMPL_FUNCTION で失敗します。

定義されている場所 タイプ メンバー
CNI_VFT オプション iFpGetAttribute2

構文

CciSize cniGetAttribute2(
  int          returnCode,
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     buffer,
  int          bufsize);

パラメーター

context
ノードによって作成され、cniCreateNodeContext 関数によって戻される、ノードのインスタンスのコンテキストのアドレス (入力)。
returnCode (出力)
int へのポインター。 戻ったら、ノードは、この int が完了の状況を記述する値を確実に格納するようにしなければなりません。 考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
attrName
値が検索される属性の名前 (入力)。
buffer
属性値のコピー先のバッファーのアドレス (出力)。
bufsize
buffer パラメーターで指定した、CciChar 単位のバッファーの長さ (入力)。

戻り値

  • 正常に実行されると、提供されるバッファーに属性値がコピーされ、コピーされた CciChar 文字の数が戻されます。
  • バッファーの大きさが不十分で属性値を含めることができない場合、returnCode は CCI_BUFFER_TOO_SMALL に設定され、必要な CciChar の数が戻されます。
  • attrName がこのノードにとって既知ではない場合、returnCode は CCI_ATTRIBUTE_UNKNOWN に設定されます。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:11


参照トピック参照トピック | バージョン 8.0.0.5 | as24698_