Freigeben über


smiVALUE-Struktur (winsnmp.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 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

Weitere Informationen

SnmpCreateVbl

SnmpFreeDescriptor

SnmpGetVb

Übersicht über die WinSNMP-API

WinSNMP-Strukturen

smiOCTETS

smiOID