AsnAny-Struktur (snmp.h)

[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die AsnAny-Struktur enthält einen SNMP-Variablentyp und -Wert. Diese Struktur ist ein Element der SnmpVarBind-Struktur , das als Parameter in vielen SNMP-Funktionen verwendet wird. Diese Struktur wird nicht von den WinSNMP-API-Funktionen verwendet.

Syntax

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;

Member

asnType

Typ: BYTE

Gibt den Typ der Variablen an. Dieser Member darf nur einer der folgenden Werte sein.

Wert Bedeutung
ASN_INTEGER
Gibt eine 32-Bit-Ganzzahlvariable mit Vorzeichen an.
ASN_INTEGER32
Gibt eine 32-Bit-Ganzzahlvariable mit Vorzeichen an.
ASN_UNSIGNED32
Gibt eine 32-Bit-Ganzzahlvariable ohne Vorzeichen an. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
ASN_COUNTER64
Gibt eine Zählervariable an, die erhöht wird, bis sie einen Maximalwert von (2^64) – 1 erreicht.
ASN_OCTETSTRING
Gibt eine Oktettzeichenfolgenvariable an.
ASN_BITS
Gibt eine Variable an, die eine Enumeration von benannten Bits ist.
ASN_OBJECTIDENTIFIER
Gibt eine Objektbezeichnervariable an.
ASN_SEQUENCE
Gibt eine ASN-Sequenzvariable an.
ASN_IPADDRESS
Gibt eine IP-Adressvariable an.
ASN_COUNTER32
Gibt eine Zählervariable an.
ASN_GAUGE32
Gibt eine Messgerätvariable an. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
ASN_TIMETICKS
Gibt eine Timeticks-Variable an.
ASN_OPAQUE
Gibt eine undurchsichtige Variable an.
SNMP_EXCEPTION_NOSUCHOBJECT
Gibt an, dass das bereitgestellte Objekt nicht verfügbar ist.
SNMP_EXCEPTION_NOSUCHINSTANCE
Gibt an, dass die bereitgestellte instance nicht verfügbar ist.
SNMP_EXCEPTION_ENDOFMIBVIEW
Gibt an, dass das Ende der MIB-Ansicht erreicht wurde.

asnValue

Enthält den Wert der Variablen. Dieser Member kann nur einer der folgenden Werte sein.

number

Typ: AsnInteger32 Greift auf eine 32-Bit-Ganzzahlvariable mit Vorzeichen zu.

unsigned32

Typ: AsnUnsigned32 Greift auf eine 32-Bit-Ganzzahlvariable ohne Vorzeichen zu.

counter64

Typ: AsnCounter64 Greift auf eine Zählervariable zu, die erhöht wird, bis sie einen Maximalwert von (2^64) – 1 erreicht.

Zeichenfolge

Typ: AsnOctetString Greift auf eine Oktettzeichenfolgenvariable zu.

Bit

Typ: AsnBits Greift auf eine Variable zu, bei der es sich um eine Enumeration benannter Bits mit nicht negativen, zusammenhängenden Werten handelt, die bei null beginnen.

Objekt (object)

Typ: AsnObjectIdentifier Greift auf eine Objektbezeichnervariable zu.

sequence

Typ: AsnSequence Greift auf eine ASN-Sequenzvariable zu.

address

Typ: AsnIPAddress Greift auf eine IP-Adressvariable zu.

Zähler

Typ: AsnCounter32 Greift auf eine Zählervariable zu, die erhöht wird, bis sie den Maximalwert (2^32) – 1 erreicht.

Tachometerdiagramm

Typ: AsnGauge32 Greift auf eine Messgerätvariable zu.

ticks

Typ: AsnTimeticks Greift auf eine timeticks-Zählervariable zu, die relativ zu einem bestimmten Timerereignis ist.

Beliebige

Typ: AsnOpaque Greift auf eine undurchsichtige Variable zu.

asnValue.number

asnValue.unsigned32

asnValue.counter64

asnValue.string

asnValue.bits

asnValue.object

asnValue.sequence

asnValue.address

asnValue.counter

asnValue.gauge

asnValue.ticks

asnValue.arbitrary

Hinweise

Um die Definition des unsigned32-Typs zu verwenden, der in RFC 1902 beschrieben wird, können Sie den ASN_GAUGE32 Variablentyp angeben. Derzeit gibt der Variabletyp ASN_UNSIGNED32 den in RFC 1442 beschriebenen UInteger32-Typ an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile snmp.h

Weitere Informationen

SNMP-Strukturen

Simple Network Management-Protokoll (SNMP) – Übersicht

SnmpExtensionMonitor

SnmpVarBind