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

Статья
03/13/2024

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

Приложение WinSNMP использует функцию SnmpFreeDescriptor для информирования реализации Microsoft WinSNMP о том, что ему больше не требуется доступ к объекту дескриптора. Эта функция WinSNMP сигнализирует реализации об освобождении памяти, выделенной для объекта дескриптора.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeDescriptor(
  [in] smiUINT32   syntax,
  [in] smiLPOPAQUE descriptor
);

Параметры

[in] syntax

Указывает тип данных синтаксиса целевого объекта дескриптора.

[in] descriptor

Указатель на структуру smiOPAQUE , содержащую целевой объект дескриптора для освобождения.

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

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

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

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Функция SnmpStartup не была успешно завершена.
SNMPAPI_ALLOC_ERROR	Произошла ошибка при выделении памяти.
SNMPAPI_SYNTAX_INVALID	Недопустимый параметр синтаксиса .
SNMPAPI_OPERATION_INVALID	Недопустимый параметр дескриптора . Дополнительные сведения см. в следующем разделе Примечаний.
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Реализация выделяет и освобождает память для выходных объектов дескриптора с переменной длиной. Выделение и освобождение памяти ограничены реализацией, за исключением интерфейса, который предоставляет функция SnmpFreeDescriptor . Дополнительные сведения см. в разделе Освобождение дескрипторов WinSNMP.

Реализация возвращает код ошибки SNMPAPI_OPERATION_INVALID, если параметр дескриптора указывает выделение памяти, которое реализация выпустила в предыдущем вызове SnmpFreeDescriptor. Функция возвращает тот же код ошибки, если параметр дескриптора указывает выделение памяти, которое реализация не сделала для вызывающего приложения WinSNMP.

Требования

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

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

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