snmpDuplicatePdu 函数 (winsnmp.h)

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

WinSNMP SnmpDuplicatePdu 函数 (PDU 参数标识的 PDU) 复制 SNMP 协议数据单元,为重复的 PDU 分配任何必要的内存。

语法

HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
  [in] HSNMP_SESSION session,
  [in] HSNMP_PDU     PDU
);

参数

[in] session

WinSNMP 会话的句柄。

[in] PDU

要复制的 PDU 的句柄。 SnmpDuplicatePdu 函数为调用应用程序中的每个 PDU 提供唯一句柄。

返回值

如果函数成功,则返回值是标识新的重复 PDU 的句柄。

如果函数失败,则返回值SNMPAPI_FAILURE。 若要获取扩展的错误信息,请调用 SnmpGetLastErrorSnmpGetLastError 函数可能会返回以下错误之一。

返回代码 说明
SNMPAPI_NOT_INITIALIZED
SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR
内存分配期间出错。
SNMPAPI_SESSION_INVALID
会话句柄无效。
SNMPAPI_PDU_INVALID
PDU 句柄无效。
SNMPAPI_OTHER_ERROR
发生未知或未定义的错误。

注解

若要释放 SnmpDuplicatePdu 函数为新 PDU 分配的资源,WinSNMP 应用程序必须调用 SnmpFreePdu 函数。

要求

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

另请参阅

SnmpFreePdu

SnmpGetPduData

WinSNMP 函数

WinSNMP API 概述