Поделиться через

Функция SnmpFreeContext (winsnmp.h)

  • Статья

[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]

Функция WinSNMP SnmpFreeContext освобождает ресурсы, связанные с контекстом 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
Header winsnmp.h
Библиотека Wsnmp32.lib
DLL Wsnmp32.dll

См. также раздел

SnmpCleanup

SnmpClose

SnmpStrToContext

Функции WinSNMP

Общие сведения об API WinSNMP