smiOCTETS 结构 (winsnmp.h)

[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]

WinSNMP smiOCTETS 结构将上下文字符串传递给多个 WinSNMP 函数。 结构还描述并接收编码的 SNMP 消息。

smiOCTETS 结构包含指向长度可变的 SNMP 八进制字符串的指针。 结构可以是 smiVALUE 结构的成员。

语法

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

成员

len

指定一个无符号长整数值,该值指示 ptr 成员指向的八进制字符串数组中的字节数。

ptr

指向包含相关八进制字符串的字节数组的指针。 不需要 NULL 终止字节。

注解

Microsoft WinSNMP 实现为所有输出 smiOCTETS 结构分配和解除分配内存。 WinSNMP 应用程序不应释放实现为 smiOCTETS 结构的 ptr 成员分配的内存。 相反,应用程序必须调用 SnmpFreeDescriptor 函数来释放内存。

由于 WinSNMP 应用程序为具有可变长度的输入描述符对象分配内存,因此它必须释放该内存。 有关详细信息,请参阅 WinSNMP 数据管理概念

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 winsnmp.h

另请参阅

SnmpContextToStr

SnmpDecodeMsg

SnmpEncodeMsg

SnmpFreeDescriptor

SnmpStrToContext

WinSNMP API 概述

WinSNMP 结构

smiVALUE