AsnAny 结构 (snmp.h)

项目
08/26/2023

[SNMP 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]

AsnAny 结构包含 SNMP 变量类型和值。此结构是 SnmpVarBind 结构的成员，该结构在许多 SNMP 函数中用作参数。 WinSNMP API 函数不使用此结构。

语法

typedef struct {
  BYTE  asnType;
  union {
    AsnInteger32        number;
    AsnUnsigned32       unsigned32;
    AsnCounter64        counter64;
    AsnOctetString      string;
    AsnBits             bits;
    AsnObjectIdentifier object;
    AsnSequence         sequence;
    AsnIPAddress        address;
    AsnCounter32        counter;
    AsnGauge32          gauge;
    AsnTimeticks        ticks;
    AsnOpaque           arbitrary;
  } asnValue;
} AsnAny;

成员

asnType

类型： BYTE

指示变量的类型。此成员只能是以下值之一。

值	含义
ASN_INTEGER	指示 32 位有符号整数变量。
ASN_INTEGER32	指示 32 位有符号整数变量。
ASN_UNSIGNED32	指示 32 位无符号整数变量。有关更多信息，请参见下面的“备注”部分。
ASN_COUNTER64	指示计数器变量在达到最大值 (2^64) - 1 之前增加。
ASN_OCTETSTRING	指示八进制字符串变量。
ASN_BITS	指示一个变量，该变量是命名位的枚举。
ASN_OBJECTIDENTIFIER	指示对象标识符变量。
ASN_SEQUENCE	指示 ASN 序列变量。
ASN_IPADDRESS	指示 IP 地址变量。
ASN_COUNTER32	指示计数器变量。
ASN_GAUGE32	指示仪表变量。有关更多信息，请参见下面的“备注”部分。
ASN_TIMETICKS	指示 timeticks 变量。
ASN_OPAQUE	指示不透明的变量。
SNMP_EXCEPTION_NOSUCHOBJECT	指示提供的对象不可用。
SNMP_EXCEPTION_NOSUCHINSTANCE	指示提供的实例不可用。
SNMP_EXCEPTION_ENDOFMIBVIEW	指示已到达 MIB 视图的末尾。

asnValue

包含变量的值。此成员只能是以下值之一。

数字

类型： AsnInteger32 访问 32 位有符号整数变量。

unsigned32

类型： AsnUnsigned32 访问 32 位无符号整数变量。

counter64

类型： AsnCounter64 访问一个计数器变量，该变量将递增，直到其达到 (最大值 2^64) - 1。

字符串

类型： AsnOctetString 访问八进制字符串变量。

位

类型： AsnBits 访问一个变量，该变量是具有非负连续值的命名位的枚举，从零开始。

对象 (object)

类型： AsnObjectIdentifier 访问对象标识符变量。

sequence

类型： AsnSequence 访问 ASN 序列变量。

address

类型： AsnIPAddress 访问 IP 地址变量。

counter

类型： AsnCounter32 访问一个计数器变量，该变量将递增，直到其达到最大值 (2^32) - 1。

gauge

类型： AsnGauge32 访问仪表变量。

ticks

类型： AsnTimeticks 访问相对于特定计时器事件的 timeticks 计数器变量。

任意

类型： AsnOpaque 访问不透明变量。

asnValue.number

asnValue.unsigned32

asnValue.counter64

asnValue.string

asnValue.bits

asnValue.object

asnValue.sequence

asnValue.address

asnValue.counter

asnValue.gauge

asnValue.ticks

asnValue.arbitrary

注解

若要使用 RFC 1902 中所述的 Unsigned32 类型的定义，可以指定ASN_GAUGE32变量类型。目前，ASN_UNSIGNED32变量类型指定 RFC 1442 中所述的 UInteger32 类型。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	snmp.h

另请参阅

通过