smiVALUE 结构 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
WinSNMP smiVALUE 结构描述与变量绑定条目中的变量名称关联的值。
smiVALUE 结构的语法成员包含 WinSNMP 数据类型,该数据类型指示值成员中的数据类型。 结构 的值 成员是所有可能的 WinSNMP 数据类型的并集。
语法
typedef struct {
smiUINT32 syntax;
union {
smiINT sNumber;
smiUINT32 uNumber;
smiCNTR64 hNumber;
smiOCTETS string;
smiOID oid;
smiBYTE empty;
} value;
} smiVALUE, *smiLPVALUE;
成员
syntax
类型: smiUINT32
指定一个无符号长整数,该整数指示 值 成员的语法数据类型。 此成员只能是下表中列出的类型之一。 有关详细信息,请参阅 WinSNMP 数据类型 和 RFC 1902“简单网络管理协议版本 2 的管理信息的结构 (SNMPv2) ”。
最后三种语法类型描述了 SNMP 版本 2C (SNMPv2C) 框架下的异常情况。
value
指定所有可能的 WinSNMP 语法数据类型的并集,包括 smiOID 或 smiOCTETS 描述符类型。
sNumber
类型: smiINT 指定有符号的长整数值。
uNumber
类型: smiUINT32 指定 32 位无符号长整数值。
hNumber
类型: smiCNTR64 指定 64 位无符号整数值
字符串
类型: smiOCTETS 指定字符串。
oid
类型: smiOID 指定 OID) (对象标识符。
empty
类型: smiBYTE 指定空成员。
value.sNumber
value.uNumber
value.hNumber
value.string
value.oid
value.empty
注解
WinSNMP 应用程序必须检查 smiVALUE 结构的语法成员才能正确取消引用值成员。 值成员可以包含简单的标量值或非标量值,如 smiOCTETS 或 smiOID 描述符结构。
如果 语法 成员指示 值 成员是 smiOCTETS 或 smiOID 描述符结构,则 WinSNMP 应用程序必须确定是否释放为结构分配的资源。 Microsoft WinSNMP 实现为所有输出 smiOCTETS 和 smiOID 结构分配和解除分配内存。 应用程序必须调用 SnmpFreeDescriptor 函数来释放这些结构的 ptr 成员的内存。
由于 WinSNMP 应用程序为具有可变长度的输入描述符分配内存,因此它必须释放该内存。 有关详细信息,请参阅 WinSNMP 数据管理概念。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | winsnmp.h |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈