cciGetTargetTerminalName

此函数为指定连接返回目标节点的输入终端的名称。

语法

CciSize cciGetTargetTerminalName (int* returnCode,
                                   CciConnection* connection,
                                   CciChar* value,
                                     CciSize                    length);

参数

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

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

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

返回值

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

示例

void myPropagatedMessageCallback(
                        CciDataContext* userContext,
                        CciMessage* message,
                        CciMessage* localEnvironment,
                          CciMessage* exceptionList,          
                        CciMessage* environment,
                        CciConnection* connection){
     int          rc = CCI_SUCCESS;
   CciChar targetTerminalName[initialStringBufferLength];
   cciGetTargetTerminalName(&rc,
                            connection,
                            targetTerminalName,
                            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
as36030_