smiOID-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-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