SnmpFreeContext 函数 (winsnmp.h)

  • 项目

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

WinSNMP SnmpFreeContext 函数释放与 SNMP 上下文关联的资源，SNMP 上下文是一组托管对象资源。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
  [in] HSNMP_CONTEXT context
);

参数

[in] context

将释放其资源的 SNMP 上下文的句柄。

返回值

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

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

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

注解

当 WinSNMP 应用程序调用 SnmpClose 函数或 SnmpCleanup 函数时，Microsoft WinSNMP 实现会释放它为 WinSNMP 会话分配的所有资源。 但是，建议 WinSNMP 应用程序使用对应于资源的 WinSNMP 函数释放单个资源。 例如，应用程序应调用 SnmpFreeContext 函数，以释放由调用 SnmpStrToContext 函数分配的资源。 这可减少实现的工作负荷，并应增强实现对所有应用程序的服务。

有关其他信息，请参阅 WinSNMP 数据管理概念。

要求

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

另请参阅

SnmpCleanup

SnmpClose

SnmpStrToContext

WinSNMP 函数

WinSNMP API 概述