RSiPathAddSetStat 또는 RSiPathAddSetStatx 서브루틴

용도

이미 정의된 SpmiStatSet에 단일 통계 값을 추가하십시오.

라이브러리

RSI 라이브러리 (libSpmi.a)

구문

#include sys/Rsi.h
struct SpmiStatVals *RSiPathAddSetStat (rhandle, statset,
path)
RSiHandle rhandle;
struct SpmiStatSet *statset;
char *path;
struct SpmiStatVals *RSiPathAddSetStatx (rhandlex, statset,
path)
RSiHandle rhandlex;
struct SpmiStatSet *statset;
char *path;

매개변수

처리 (rhandle)
RSiOpen 서브루틴에 의해 이전에 초기화된 유효한 RSiHandle 핸들을 가리켜야 합니다.
처리 (rhandle)
RSiOpenx 서브루틴에 의해 이전에 초기화된 유효한 RSiHandlex 핸들을 가리켜야 합니다.
statset
구조체 SpmiStatSet 유형의 구조체에 대한 포인터여야 하며, 이전에 성공적인 RSiCreateStatSet 또는 RSiCreateStatSetx 서브루틴 호출에 의해 반환된 구조체여야 합니다.
경로
SpmiStatSet 추가할 통계 값의 전체 값 경로 이름이어야 합니다. 값 경로 이름에는 종료 슬래시가 포함되지 않아야 합니다. 값 경로 이름은 슬래시로 시작하지 않습니다.

리턴 값

성공하면 서브루틴은 구조체 SpmiStatVals 유형의 구조체에 대한 포인터를 반환합니다. 오류가 발생하면 NULL이 리턴되고 오류 텍스트가 외부 문자 배열 RSiEMsg에 배치될 수 있습니다. 현재 로컬 버퍼 크기가 허용하는 것보다 더 많은 값을 통계 집합에 추가하려고 하면 RSiErrno RSiTooMany 설정됩니다. 원격 호스트의 xmservd 데몬이 허용하는 버퍼 크기보다 많은 값을 추가하려고 하면 RSiErrno RSiBadStat 설정되고 반환된 패킷의 상태 필드가 too_many_values로 설정됩니다.

외부 정수 RSiMaxValues 데이터 소비자의 버퍼 크기에서 허용되는 최대 값 수를 보유합니다.

오류 코드

모든 원격 통계 인터페이스 (RSI) 서브루틴은 외부 변수를 사용하여 오류 정보를 제공합니다. 이러한 변수에 액세스하려면 애플리케이션 프로그램이 다음 외부 변수를 정의해야 합니다.

  • 외부 문자 RSiEMsg[];
  • 외부 int RSiErrno;

서브루틴이 오류 없이 리턴되면 RSiErrno 변수가 RSiOkay 로 설정되고 RSiEMsg 문자 배열이 비어 있습니다. 오류가 감지되면 RSiErrno 변수는 RSiErrorType 열거형에 정의된 대로 오류 코드를 반환합니다.

파일

항목 설명
/usr/include/sys/Rsi.h 애플리케이션 프로그램이 RSI에 액세스하는 데 사용할 수 있는 서브루틴, 데이터 구조, 핸들 및 매크로를 선언합니다.