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

Статья
08/27/2023

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

Функция SnmpFreeVbl WinSNMP освобождает ресурсы, связанные со списком привязок переменных. Это ресурсы, выделенные ранее вызовом функции SnmpCreateVbl или SnmpDuplicateVbl в приложении WinSNMP.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Параметры

[in] vbl

Дескриптор списка привязок переменных для освобождения.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет SNMPAPI_SUCCESS.

Если функция завершается сбоем, возвращаемое значение будет SNMPAPI_FAILURE. Чтобы получить расширенные сведения об ошибке, вызовите SnmpGetLastError , указав значение NULL в параметре сеанса . Функция SnmpGetLastError может возвращать одну из следующих ошибок.

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Функция SnmpStartup не была успешно завершена.
SNMPAPI_ALLOC_ERROR	Произошла ошибка при выделении памяти.
SNMPAPI_VBL_INVALID	Недопустимый параметр vbl .
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Приложение WinSNMP должно освободить ресурсы, связанные со списком привязок каждой переменной. Для этого необходимо сопоставить каждый вызов с функциями SnmpCreateVbl и SnmpDuplicateVbl с соответствующим вызовом функции SnmpFreeVbl . Чтобы избежать утечек памяти, приложение WinSNMP должно вызвать SnmpFreeVbl , прежде чем повторно использовать дескриптор для списка привязок переменных в последующем вызове SnmpCreateVbl или SnmpDuplicateVbl.

Если приложение вызывает функцию SnmpClose или SnmpCleanup , реализация Microsoft WinSNMP освобождает все ресурсы, выделенные для сеанса WinSNMP. Однако даже если приложение не использует дескриптор списка привязок переменных, рекомендуется, чтобы приложение освобождало отдельные ресурсы привязок переменных с помощью функции SnmpFreeVbl . Это снижает рабочую нагрузку на реализацию и должно улучшить ее обслуживание для всех приложений. Дополнительные сведения см. в статье Основные понятия Управление данными WinSNMP.

Требования


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