snmpOidCopy 函数 (winsnmp.h)

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

WinSNMP SnmpOidCopy 函数复制 SNMP 对象标识符，为副本分配任何必要的内存。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
  [in]  smiLPCOID srcOID,
  [out] smiLPOID  dstOID
);

[in] srcOID

指向要复制的 smiOID 结构的指针。

[out] dstOID

指向 smiOID 结构的指针，用于接收 由 srcOID 参数指定的对象标识符的副本。

如果函数成功，则返回值为复制的对象标识符中的子标识符数。此数字也是 dstOID 参数指向的 smiOID 结构的 len 成员的值。

如果函数失败，则返回值SNMPAPI_FAILURE。若要获取扩展的错误信息，请调用 SnmpGetLastError，并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。

输入时，SnmpOidCopy 函数将忽略 dstOID 参数指向的 smiOID 结构的成员。如果函数成功完成，Microsoft WinSNMP 实现将覆盖 smiOID 成员。

WinSNMP 应用程序必须调用 SnmpFreeDescriptor 函数，以使实现能够释放为 dstOID 参数指向的 smiOID 结构的 ptr 成员分配的资源。有关其他信息，请参阅 WinSNMP 数据管理概念和释放 WinSNMP 描述符。


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