更新开始

cciGetSourceTerminalName

此函数为指定连接返回源节点的输出终端的名称。

语法

CciSize cciGetSourceTerminalName (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 sourceTerminalName[initialStringBufferLength];
cciGetSourceTerminalName(&rc,
connection,
sourceTerminalName,
initialStringBufferLength);
}
相关概念
建立用户出口
相关任务
建立用户出口
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
as36020_


更新结束