smiOID-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-smiOID-Struktur übergibt Objektbezeichner an mehrere WinSNMP-Funktionen. Die Struktur empfängt auch den Variablennamen eines Variablenbindungseintrags in einem Aufruf der SnmpGetVb-Funktion .
Die smiOID-Struktur enthält einen Zeiger auf ein Array mit variabler Länge der Unteridentifizierer eines benannten Objekts. Die -Struktur kann ein Element der smiVALUE-Struktur sein.
Syntax
typedef struct {
smiUINT32 len;
smiLPUINT32 ptr;
} smiOID, *smiLPOID;
Member
len
Gibt einen ganzzahligen Wert ohne Vorzeichen an, der die Anzahl der Elemente im Array angibt, auf die das ptr-Element verweist.
ptr
Zeiger auf ein Array von langen ganzzahlen ohne Vorzeichen, die die Unteridentifizierer des Objektbezeichners darstellen.
Hinweise
In einer smiOID-Struktur ist das Format des Arrays, auf das das ptr-Element verweist, ein Unteridentifizierer pro Arrayelement. Die Zeichenfolge "1.3.6.1" wäre beispielsweise ein Array von vier Elementen {1,3,6,1}.
Die Microsoft WinSNMP-Implementierung weist arbeitsspeicher für alle Ausgabe-smiOID-Strukturen zu und verteilt diesen. Die WinSNMP-Anwendung sollte keinen Arbeitsspeicher freigeben, den die Implementierung dem ptr-Member einer smiOID-Struktur zuweist. Stattdessen muss die Anwendung die SnmpFreeDescriptor-Funktion aufrufen, um den Arbeitsspeicher freizugeben.
Da die WinSNMP-Anwendung Arbeitsspeicher für Eingabedeskriptorobjekte mit variablen Längen zuweist, muss dieser Arbeitsspeicher freigegeben werden. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Kopfzeile | winsnmp.h |