SnmpClose 函数 (winsnmp.h)

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

SnmpClose 函数使 Microsoft WinSNMP 实现能够解除分配与 WinSNMP 会话关联的内存、资源和数据结构。 WinSNMP SnmpClose 函数还会关闭由于调用 SnmpCreateSession 函数而打开的实现的通信机制。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
  [in] HSNMP_SESSION session
);

参数

[in] session

要关闭的 WinSNMP 会话的句柄。

返回值

如果函数成功，则返回值SNMPAPI_SUCCESS。

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

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

注解

建议 WinSNMP 应用程序为应用程序使用 SnmpCreateSession 函数打开的每个会话调用 SnmpClose 函数一次。 如果 WinSNMP 应用程序意外终止，它必须在终止之前调用 SnmpCleanup ，以使实现能够解除分配所有资源。 实现处理一个 SnmpCleanup 调用，就好像它是一系列 SnmpClose 调用一样，对由于调用 SnmpCreateSession 而打开的每个会话一次调用。

当实现关闭会话时，它会放弃会话的所有未完成的传入和传出异步请求和回复。 有关其他信息，请参阅 WinSNMP 会话。

要求

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

另请参阅

SnmpCleanup

SnmpCreateSession

WinSNMP 函数

WinSNMP API 概述