RSiStatGetPath或RSiStatGetPathx子程序

用途

查找由 SpmiStatVals 指针标识的统计信息的完整路径名。

库

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h

char *RSiStatGetPath (rhandle, svp)
RSiHandle rhandle;
struct SpmiStatVals *svp;

char *RSiStatGetPathx (rhandlex, svp)
RSiHandlex rhandlex;
struct SpmiStatVals *svp;

描述

RSiStatGetPath或RSiStatGetPathx子程序执行以下操作：

1. 验证第二个参数标识的SpmiStatVals统计量是否存在。
2. 返回一个指向包含统计信息的完整值路径名的字符数组的指针。

当重复调用RSiStatGetPath或RSiStatGetPathx子程序时，返回指针指向的内存区域将被释放。 对于子例程的每次调用，将分配一个新的内存区域并返回其地址。

如果调用程序在发出RSiStatGetPath或RSiStatGetPathx子程序调用后需要返回的字符串，程序必须在重新发出子程序调用前将返回的字符串复制到本地分配的内存中。

参数

处理

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

汉德莱克斯

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

斯夫普

必须是成功调用RSiPathAddSetStat或RSiPathAddSetStatx子程序后返回的structSpmiStatVals类型句柄。

返回值

如果成功，RSiStatGetPath或RSiStatGetPathx子程序会返回一个指向字符数组的指针，该数组包含统计量的完整路径名。 如果不成功，子程序将返回一个 NULL 值，并将错误文本放入外部字符数组RSiEMsg 中。

错误代码

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

• extern charRSiEMsg[]；
• extern intRSiErrno;

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

文件