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

Статья
08/27/2023

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

Функция SnmpFreePdu WinSNMP освобождает ресурсы, связанные с единицей данных протокола SNMP (PDU), созданной функцией SnmpCreatePdu или SnmpDuplicatePdu .

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
  [in] HSNMP_PDU PDU
);

Параметры

[in] PDU

Дескриптор SNMP PDU для освобождения.

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

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

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

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR	Ошибка при выделении памяти.
SNMPAPI_PDU_INVALID	Недопустимый дескриптор PDU.
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

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

В WinSNMP запись привязки переменной существует только в списке привязок переменных, даже если список привязок переменных содержит только одну запись.

Требования

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

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

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