asnAny 結構 (snmp.h)

發行項
03/05/2024

[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

包含變數的值。這個成員只能是下列其中一個值。

number

類型： 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 存取量測計變數。

刻度

類型： 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

另請參閱

SNMP 結構

Simple Network Management Protocol (SNMP) 概觀

SnmpExtensionMonitor

SnmpVarBind

共用方式為