smiVALUE-Struktur (winsnmp.h)

Artikel
08/27/2023

[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 WinSNMP smiVALUE-Struktur beschreibt den Wert, der einem Variablennamen in einem Variablenbindungseintrag zugeordnet ist.

Das Syntaxelement der smiVALUE-Struktur enthält einen WinSNMP-Datentyp, der den Typ der Daten im Wertmember angibt. Das Wertelement der Struktur ist die Vereinigung aller möglichen WinSNMP-Datentypen.

Syntax

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

Member

syntax

Typ: smiUINT32

Gibt einen ganzzahligen Wert ohne Vorzeichen an, der den Syntaxdatentyp des Wertmembers angibt. Bei diesem Member kann es sich nur um einen der in der folgenden Tabelle aufgeführten Typen handeln. Weitere Informationen finden Sie unter WinSNMP-Datentypen und RFC 1902, "Struktur der Verwaltungsinformationen für Version 2 des Simple Network Management Protocol (SNMPv2)."

Syntaxdatentyp	Bedeutung
SNMP_SYNTAX_INT	Gibt eine 32-Bit-Ganzzahlvariable mit Vorzeichen an.
SNMP_SYNTAX_OCTETS	Gibt eine Oktettzeichenfolgenvariable an, bei der es sich um binäre oder textuelle Daten handelt.
SNMP_SYNTAX_NULL	Gibt einen NULL-Wert an.
SNMP_SYNTAX_OID	Gibt eine Objektbezeichnervariable an, die ein zugewiesener Name mit maximal 128 Unteridentifizierern ist.
SNMP_SYNTAX_INT32	Gibt eine 32-Bit-Ganzzahlvariable mit Vorzeichen an.
SNMP_SYNTAX_IPADDR	Gibt eine 32-Bit-Internetadressenvariable an.
SNMP_SYNTAX_CNTR32	Gibt eine Zählervariable an, die erhöht wird, bis sie einen Maximalwert von (2^32) – 1 erreicht.
SNMP_SYNTAX_GAUGE32	Gibt eine Messgerätvariable an, bei der es sich um eine nicht negative ganze Zahl handelt, die einen Maximalwert erhöhen oder verringern, aber nie überschreiten kann.
SNMP_SYNTAX_TIMETICKS	Gibt eine Zählervariable an, die die Zeit in hundertstel Sekunden misst, bis sie einen Maximalwert von (2^32) – 1 erreicht. Es handelt sich um eine nicht negative ganze Zahl, die relativ zu einem bestimmten Timerereignis ist.
SNMP_SYNTAX_OPAQUE	Dieser Typ bietet Abwärtskompatibilität und sollte nicht für neue Objekttypen verwendet werden. Es unterstützt die Funktion, beliebige ASN.1-Syntax (Abstract Syntax Notation 1) zu übergeben.
SNMP_SYNTAX_CNTR64	Gibt eine Zählervariable an, die erhöht wird, bis sie einen Maximalwert von (2^64) – 1 erreicht.
SNMP_SYNTAX_UINT32	Gibt eine 32-Bit-Ganzzahlvariable ohne Vorzeichen an.
SNMP_SYNTAX_NOSUCHOBJECT	Gibt an, dass der -Agent den Objekttyp, der der Variablen entspricht, nicht unterstützt.
SNMP_SYNTAX_NOSUCHINSTANCE	Gibt an, dass das Objekt instance für den Vorgang nicht vorhanden ist.
SNMP_SYNTAX_ENDOFMIBVIEW	Gibt an, dass die WinSNMP-Anwendung versucht, auf einen Objektbezeichner zu verweisen, der sich über das Ende der vom Agent unterstützten MIB-Struktur befindet.

Die letzten drei Syntaxtypen beschreiben Ausnahmebedingungen unter dem FRAMEWORK SNMP Version 2C (SNMPv2C).

value

Gibt die Vereinigung aller möglichen WinSNMP-Syntaxdatentypen an, einschließlich der Deskriptortypen smiOID oder smiOCTETS .

sNumber

Typ: smiINT Gibt einen ganzzahligen Wert mit Vorzeichen an.

uNumber

Typ: smiUINT32 Gibt einen 32-Bit-Wert ohne Vorzeichen an.

hNumber

Typ: smiCNTR64 Gibt einen 64-Bit-Ganzzahlwert ohne Vorzeichen an.

Zeichenfolge

Typ: smiOCTETS Gibt eine Zeichenfolge an.

oid

Typ: smiOID Gibt einen Objektbezeichner (Object Identifier, OID) an.

empty

Typ: smiBYTE Gibt ein leeres Element an.

value.sNumber

value.uNumber

value.hNumber

value.string

value.oid

value.empty

Hinweise

Eine WinSNMP-Anwendung muss das Syntaxmember einer smiVALUE-Struktur überprüfen, um den Wertmember ordnungsgemäß zu deleiten. Das Wertmember kann einen einfachen skalaren Wert oder einen nicht skalaren Wert wie einen smiOCTETS oder eine smiOID-Deskriptorstruktur enthalten.

Wenn das Syntaxmember angibt, dass es sich bei dem Wertmember um eine smiOCTETS - oder eine smiOID-Deskriptorstruktur handelt, muss die WinSNMP-Anwendung bestimmen, ob die für die Struktur zugewiesenen Ressourcen freigegeben werden sollen. Die Microsoft WinSNMP-Implementierung weist arbeitsspeicher für alle Ausgabestrukturen smiOCTETS und smiOID zu und verwaltet diesen. Die Anwendung muss die SnmpFreeDescriptor-Funktion aufrufen, um den Arbeitsspeicher für das ptr-Element dieser Strukturen freizugeben.

Da die WinSNMP-Anwendung Arbeitsspeicher für Eingabedeskriptoren mit variablen Längen zuweist, muss sie diesen Arbeitsspeicher freigeben. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.

Anforderungen

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