smiOCTETS-Struktur (winsnmp.h)

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

Die WinSNMP-smiOCTETS-Struktur übergibt Kontextzeichenfolgen an mehrere WinSNMP-Funktionen. Die -Struktur beschreibt und empfängt auch codierte SNMP-Nachrichten.

Die smiOCTETS-Struktur enthält einen Zeiger auf eine SNMP-Oktettzeichenfolge variabler Länge. Die -Struktur kann ein Element der smiVALUE-Struktur sein.

Syntax

typedef struct {
  smiUINT32 len;
  smiLPBYTE ptr;
} smiOCTETS, *smiLPOCTETS;

Member

len

Gibt einen wert ohne Vorzeichen mit langer Ganzzahl an, der die Anzahl der Bytes im Oktettzeichenfolgenarray angibt, auf das der ptr-Member verweist.

ptr

Zeiger auf ein Bytearray, das die interessierende Oktettzeichenfolge enthält. Ein BYTE mit NULL-Beendigung ist nicht erforderlich.

Hinweise

Die Microsoft WinSNMP-Implementierung ordnet arbeitsspeicher für alle smiOCTETS-Ausgabestrukturen zu und gibt diese auf. Die WinSNMP-Anwendung sollte keinen Arbeitsspeicher freigeben, den die Implementierung dem ptr-Member einer smiOCTETS-Struktur zuordnet. Stattdessen muss die Anwendung die SnmpFreeDescriptor-Funktion aufrufen, um den Arbeitsspeicher freizugeben.

Da die WinSNMP-Anwendung Arbeitsspeicher für Eingabedeskriptorobjekte mit variabler Länge zuordnet, muss sie diesen Arbeitsspeicher freigeben. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.For more information, see 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

SnmpContextToStr

SnmpDecodeMsg

SnmpEncodeMsg

SnmpFreeDescriptor

SnmpStrToContext

Übersicht über winSNMP-API

WinSNMP-Strukturen

smiVALUE