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 |