snmpFreePdu 函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]
WinSNMP SnmpFreePdu 函数释放与 snmpCreatePdu 或 SnmpDuplicatePdu 函数创建的 (PDU) 的 SNMP 协议数据单元关联的资源。
语法
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
参数
[in] PDU
要释放的 SNMP PDU 的句柄。
返回值
如果函数成功，则返回值SNMPAPI_SUCCESS。
如果函数失败，则返回值SNMPAPI_FAILURE。 若要获取扩展的错误信息，请调用 SnmpGetLastError，并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。
| 返回代码 | 说明 |
|---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
PDU 句柄无效。 |
|
发生未知或未定义的错误。 |
注解
如果应用程序调用 SnmpClose 或 SnmpCleanup 函数，则 Microsoft WinSNMP 实现将释放它为 WinSNMP 会话分配的所有资源。 但是，建议应用程序使用与资源对应的 WinSNMP 函数释放单个资源。 这可减少实现的工作负荷，并应将实现的服务增强到所有应用程序。 应用程序应使用 SnmpFreeVbl 函数解除分配变量绑定列表资源。 有关详细信息，请参阅 WinSNMP 数据管理概念。
在 WinSNMP 下，变量绑定项仅存在于变量绑定列表中，即使变量绑定列表只包含一个条目。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winsnmp.h |
| Library | Wsnmp32.lib |
| DLL | Wsnmp32.dll |