snmpUtilIdsToA 函数 (snmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]
SnmpUtilIdsToA 函数将对象标识符 (OID) 转换为以 null 结尾的字符串。 此函数是 SNMP 实用工具 API 的元素。
语法
LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
[in] UINT *Ids,
[in] UINT IdLength
);
参数
[in] Ids
指向无符号整数数组的指针。 数组包含 OID 包含的数字序列。 IdLength 参数指定数组的长度。
有关详细信息，请参阅以下返回值和备注部分。
[in] IdLength
指定 Ids 参数指向的数组中的元素数。
返回值
函数返回一个以 null 结尾的字符串，该字符串包含 Ids 参数指向的数字数组的字符串表示形式。 字符串包含由句点 ('“分隔的数字序列。) ;例如 1.3.6.1.4.1.311。
如果 Ids 参数为 null，或者 IdLength 参数指定零，则该函数将返回字符串“<null oid>”。
返回的字符串的最大长度为 256 个字符。 如果字符串的长度超过 256 个字符，字符串将被截断并终止为三个句点的序列 ('...') 。
注解
SnmpUtilIdsToA 函数可帮助调试 SNMP 应用程序。
请注意，调用 SnmpUtilIdsToA 时，以下内存限制适用：
- Ids 参数必须指向至少包含 IdLength 整数的有效内存块，否则函数调用会导致访问冲突异常。
- SnmpUtilIdsToA 返回的字符串驻留在 SNMP 实用工具 API 分配的内存中。 应用程序不应对内存分配做出任何假设。 在再次调用 SnmpUtilIdsToA 之前，数据保证有效，因此在再次调用函数之前，应将数据复制到其他位置。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | snmp.h |
| Library | Snmpapi.lib |
| DLL | Snmpapi.dll |