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


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

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

Функция SnmpClose позволяет реализации Microsoft WinSNMP освободить память, ресурсы и структуры данных, связанные с сеансом WinSNMP. Функция SnmpClose WinSNMP также закрывает механизмы взаимодействия, открытые реализацией в результате вызова функции 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 вызывало функцию SnmpClose один раз для каждого сеанса, открытого приложением с помощью функции SnmpCreateSession . Если приложение WinSNMP неожиданно завершает работу, оно должно вызвать SnmpCleanup перед завершением, чтобы позволить реализации отменить выделение всех ресурсов. Реализация обрабатывает один вызов SnmpCleanup , как если бы это была серия вызовов SnmpClose , по одному вызову для каждого сеанса, открытого в результате вызова SnmpCreateSession.

Когда реализация закрывает сеанс, она удаляет все невыполненные входящие и исходящие асинхронные запросы и ответы для сеанса. Дополнительные сведения см. в разделе Сеансы WinSNMP.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winsnmp.h
Библиотека Wsnmp32.lib
DLL Wsnmp32.dll

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

SnmpCleanup

SnmpCreateSession

Функции WinSNMP

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