smiVALUE 구조체(winsnmp.h)

아티클
08/27/2023

[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]

WinSNMP smiVALUE 구조체는 변수 바인딩 항목의 변수 이름과 연결된 값을 설명합니다.

smiVALUE 구조체의 구문 멤버에는 값 멤버의 데이터 형식을 나타내는 WinSNMP 데이터 형식이 포함되어 있습니다. 구조체의 값 멤버는 가능한 모든 WinSNMP 데이터 형식의 공용 구조체입니다.

구문

typedef struct {
  smiUINT32 syntax;
  union {
    smiINT    sNumber;
    smiUINT32 uNumber;
    smiCNTR64 hNumber;
    smiOCTETS string;
    smiOID    oid;
    smiBYTE   empty;
  } value;
} smiVALUE, *smiLPVALUE;

멤버

syntax

형식: smiUINT32

값 멤버의 구문 데이터 형식을 나타내는 부호 없는 long 정수입니다. 이 멤버는 다음 표에 나열된 형식 중 하나일 수 있습니다. 자세한 내용은 WinSNMP 데이터 형식 및 RFC 1902, "SNMPv2(Simple Network Management Protocol) 버전 2에 대한 관리 정보 구조"를 참조하세요.

구문 데이터 형식	의미
SNMP_SYNTAX_INT	32비트 부가 정수 변수를 나타냅니다.
SNMP_SYNTAX_OCTETS	이진 또는 텍스트 데이터인 octet 문자열 변수를 나타냅니다.
SNMP_SYNTAX_NULL	NULL 값을 나타냅니다.
SNMP_SYNTAX_OID	최대 128개의 하위 ID를 가진 할당된 이름인 개체 식별자 변수를 나타냅니다.
SNMP_SYNTAX_INT32	32비트 부가 정수 변수를 나타냅니다.
SNMP_SYNTAX_IPADDR	32비트 인터넷 주소 변수를 나타냅니다.
SNMP_SYNTAX_CNTR32	최대값(2^32) – 1에 도달할 때까지 증가하는 카운터 변수를 나타냅니다.
SNMP_SYNTAX_GAUGE32	최대값을 초과하지 않고 늘리거나 줄일 수 있는 음수가 아닌 정수인 계기 변수를 나타냅니다.
SNMP_SYNTAX_TIMETICKS	최대값(2^32) – 1에 도달할 때까지 시간을 수백 초로 측정하는 카운터 변수를 나타냅니다. 특정 타이머 이벤트를 기준으로 하는 음수가 아닌 정수입니다.
SNMP_SYNTAX_OPAQUE	이 형식은 이전 버전과의 호환성을 제공하며 새 개체 형식에 사용하면 안 됩니다. ASN.1(임의 추상 구문 표기법 1) 구문을 전달하는 기능을 지원합니다.
SNMP_SYNTAX_CNTR64	최대값(2^64) – 1에 도달할 때까지 증가하는 카운터 변수를 나타냅니다.
SNMP_SYNTAX_UINT32	부호 없는 32비트 정수 변수를 나타냅니다.
SNMP_SYNTAX_NOSUCHOBJECT	에이전트가 변수에 해당하는 개체 형식을 지원하지 않음을 나타냅니다.
SNMP_SYNTAX_NOSUCHINSTANCE	작업에 대한 개체 instance 존재하지 않음을 나타냅니다.
SNMP_SYNTAX_ENDOFMIBVIEW	WinSNMP 애플리케이션이 에이전트가 지원하는 MIB 트리의 끝을 벗어난 개체 식별자를 참조하려고 했음을 나타냅니다.

마지막 세 구문 형식은 SNMP 버전 2C(SNMPv2C) 프레임워크에서 예외 조건을 설명합니다.

value

smiOID 또는 smiOCTETS 설명자 형식을 포함하여 가능한 모든 WinSNMP 구문 데이터 형식의 합집합을 지정합니다.

sNumber

형식: smiINT 서명된 긴 정수 값을 지정합니다.

uNumber

형식: smiUINT32 부호 없는 32비트 긴 정수 값을 지정합니다.

hNumber

형식: smiCNTR64 부호 없는 64비트 정수 값을 지정합니다.

문자열

형식: smiOCTETS 문자열을 지정합니다.

oid

형식: smiOID OID(개체 식별자)를 지정합니다.

비어 있음

형식: smiBYTE 빈 멤버를 지정합니다.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

설명

WinSNMP 애플리케이션은 smiVALUE 구조체의 구문 멤버를 검사 값 멤버를 올바르게 역참조해야 합니다. 값 멤버는 간단한 스칼라 값 또는 smiOCTETS 또는 smiOID 설명자 구조와 같은 비 스칼라 값을 포함할 수 있습니다.

구문 멤버가 값 멤버가 smiOCTETS 또는 smiOID 설명자 구조체임을 나타내는 경우 WinSNMP 애플리케이션은 구조체에 할당된 리소스를 해제할지 여부를 결정해야 합니다. Microsoft WinSNMP 구현은 모든 출력 smiOCTETS 및 smiOID 구조에 대한 메모리를 할당하고 할당을 취소합니다. 애플리케이션은 이러한 구조체의 ptr 멤버에 대한 메모리를 해제하려면 SnmpFreeDescriptor 함수를 호출해야 합니다.

WinSNMP 애플리케이션은 가변 길이를 가진 입력 설명자에 메모리를 할당하므로 해당 메모리를 해제해야 합니다. 자세한 내용은 WinSNMP 데이터 관리 개념을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	winsnmp.h