更新开始

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/05/19
as36030_


更新结束