RSiPathGetCx或RSiPathGetCxx子程序

用途

在上下文层次结构中搜索与上下文路径名匹配的 SpmiCx 上下文。

库

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h

cx_handle *RSiPathGetCx (rhandle, path)
RSiHandle rhandle;
char *path;

cx_handle *RSiPathGetCxx (rhandlex, path)
RSiHandlex  rhandlex;
char *path;

描述

RSiPathGetCx或RSiPathGetCxx子程序执行以下操作：

1. 在上下文层次结构中搜索上下文的给定路径名。
2. 返回在随后引用上下文时要使用的句柄。

该子程序是AIX®性能工具箱许可产品的一部分。

参数

处理

必须指向先前由 RSiOpen 子例程初始化的有效 RSiHandle 句柄。

汉德莱克斯

必须指向先前由 RSiOpenx 子例程初始化的有效 RSiHandlex 句柄。

路径

要为其返回句柄的上下文的路径名。 上下文路径名必须是完整的路径名，并且不得包含终止斜杠。 请注意，上下文路径名从不以斜杠开头。

返回值

如果成功，子例程将返回定义为指向类型为 cx_handle的结构的指针的句柄。 如果发生错误，那么将返回 NULL ，并且可能会在外部字符数组 RSiEMsg中放置错误文本。

错误代码

所有远程统计信息接口 (RSI) 子例程都使用外部变量来提供错误信息。 为了访问这些变量，应用程序必须定义下列外部变量:

• extern charRSiEMsg[]；
• extern intRSiErrno;

如果子例程未返回错误，那么 RSiErrno 变量将设置为 RSiOkay ，并且 RSiEMsg 字符数组为空。 如果检测到错误，RSiErrno变量将根据枚举RSiErrorType定义返回一个错误代码。

文件