cciGetNodeName

此函数返回指定节点的名称。

语法

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

参数

returnCode(输出)
接收来自函数(输出)的返回码。
  • CCI_INV_BUFFER_TOO_SMALL

    所提供的缓冲区大小不足以存放节点名称的值。

node(输入)
这是到节点的句柄。
value(输出)
这是缓冲区的地址,该地址由调用者分配,用来存放节点名称的值。
length
调用者分配的缓冲区的长度(以 CciChars 为单位)。

返回值

  • 如果成功,则将节点名复制到所提供的缓冲区,并返回复制的 CciChar 字符数。
  • 如果缓冲区的大小不足以包含节点名称,则 returnCode 设置为 CCI_BUFFER_TOO_SMALL,并且返回需要的 CciChars 数。

示例

void myPropagatedMessageCallback(
                        CciMessage* message,
                        CciMessage* localEnvironment,
                          CciMessage* exceptionList,          
                        CciMessage* environment,
                        CciConnection* connection){
 
  int          rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*you should now check the rc for unexpected values*/
   /*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/

}  
相关概念
建立用户出口
相关任务
建立用户出口
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as35990_