snmpMgrStrToOid 函数 (mgmtapi.h)

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

SnmpMgrStrToOid 函数将对象标识符的字符串格式转换为其内部对象标识符结构。此函数是 SNMP 管理 API 的一个元素。

语法

BOOL SNMP_FUNC_TYPE SnmpMgrStrToOid(
  [in]  LPSTR               string,
  [out] AsnObjectIdentifier *oid
);

[in] string

指向要转换的以 null 结尾的字符串的指针。

[out] oid

指向用于接收转换值的对象标识符变量的指针。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

如果函数成功，则调用 SnmpUtilOidFree 函数以释放为转换的对象标识符分配的内存。

如果应用程序将有效的对象标识符传递给 SnmpMgrStrToOid，但无法获取请求的变量，则系统组和对象标识符的语法不正确。出现这种情况的原因是 SnmpMgrStrToOid 假定对象标识符位于管理子树的 Internet MIB 下。

必须始终在对象标识符前面加上句点 (.) 才能获取正确的系统组 (，例如“.1.3.6.1.2.1.1”) 。如果应用程序传递变量“1.3.6.1.2.1.1”， SnmpMgrStrToOid 无法正确解释对象标识符。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mgmtapi.h
Library	Mgmtapi.lib
DLL	Mgmtapi.dll