cniGetAttribute2

该函数获得某个特定节点实例的属性值。设置了用户部署的所有属性后,由消息代理调用它。为了确保执行组过程停止并启动后正确配置了该节点,结果被写入代理的持久配置存储中。

在此点,节点的责任是要:
  1. 返回表示属性值的字符。
  2. 如果发生错误则抛出异常。

如果执行了 cniGetAttributecniGetAttribute2,则 cniDefineNodeClass 和 CCI_INV_IMPL_FUNCTION 失败。

在其中定义 类型 成员
CNI_VFT 可选 iFpGetAttribute2

语法

CciSize cniGetAttribute2(
  int          returnCode,
    CciContext* context,                
    CciChar*     attrName,
    CciChar*    buffer,
    int          bufsize);

参数

context
节点实例上下文的地址,由节点创建并由 cniCreateNodeContext 函数(输入)返回。
returnCode(输出)
int 指针。返回时,节点应该确保该 int 存储描述完成状态的值。可能的返回码是:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
attrName
要检索值的属性名称(输入)。
buffer
其内复制属性值的缓冲区的地址(输出)。
bufsize
buffer 参数(输入)中指定的缓冲区的长度(以 CciChar 为单位)。

返回值

  • 如果成功,将属性值复制到所提供的缓冲区并返回复制的 CciChar 字符数。
  • 如果缓冲区的大小不足以包含属性值,则 returnCode 设置为 CCI_BUFFER_TOO_SMALL,并且返回需要的 CciChars 数。
  • 如果 attrName 对于此节点来说是未知的,则 returnCode 设置成 CCI_ATTRIBUTE_UNKNOWN。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as24698_