cciGetNodeAttribute

この関数は、指定された属性の値を戻します。

構文

CciSize cciGetNodeAttribute (int* returnCode,
                         CciNode* node,
                         CciChar*     name,
                         CciChar* value,
                         CciSize         length);

パラメーター

returnCode (出力)
関数からの戻りコードを受け取ります (出力)。
  • CCI_INV_BUFFER_TOO_SMALL

    提供されたバッファーの容量が小さかったため、ノード・タイプの値を保持できませんでした。

node (入力)
これはノードへのハンドルです。
name (入力)
これは、照会中のノード属性の名前を指定する CciChar のヌル終了ストリングへのポインターです。
value (出力)
属性の値を保持するために呼び出し側によって割り振られたバッファーのアドレス。
length
呼び出し側によって割り振られたバッファーの長さ (CciChar 単位)。

戻り値

  • 正常に実行されると、提供されるバッファーに属性値がコピーされ、コピーされた CciChar 文字の数が戻されます。
  • バッファーの大きさが不十分で属性値を含めることができない場合、returnCode は CCI_BUFFER_TOO_SMALL に設定され、必要な CciChar の数が戻されます。
  • name に特定のノードに不適切な属性名を指定すると、returnCode は CCI_ATTRIBUTE_UNKOWN に設定されます。

void myPropagatedMessageCallback(
                        CciMessage* message,
                        CciMessage* localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage* environment,
                        CciConnection* connection){
 int rc = CCI_SUCCESS;
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*you should now check the rc for unexpected values*/
   CciChar queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*you should now check the rc for unexpected values*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*you should now check the rc for unexpected values*/
   /*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/
 /*sourceNodeQueueNameLength will hold the actual or required size */
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as36010_