Функция SnmpFreeDescriptor (winsnmp.h)
[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 может возвращать одну из следующих ошибок.
Код возврата | Описание |
---|---|
|
Функция SnmpStartup не была успешно завершена. |
|
Произошла ошибка при выделении памяти. |
|
Недопустимый параметр синтаксиса . |
|
Недопустимый параметр дескриптора . Дополнительные сведения см. в следующем разделе Примечаний. |
|
Произошла неизвестная или неопределенная ошибка. |
Комментарии
Реализация выделяет и освобождает память для выходных объектов дескриптора с переменной длиной. Выделение и освобождение памяти ограничены реализацией, за исключением интерфейса, который предоставляет функция SnmpFreeDescriptor . Дополнительные сведения см. в разделе Освобождение дескрипторов WinSNMP.
Реализация возвращает код ошибки SNMPAPI_OPERATION_INVALID, если параметр дескриптора указывает выделение памяти, которое реализация выпустила в предыдущем вызове SnmpFreeDescriptor. Функция возвращает тот же код ошибки, если параметр дескриптора указывает выделение памяти, которое реализация не сделала для вызывающего приложения WinSNMP.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winsnmp.h |
Библиотека | Wsnmp32.lib |
DLL | Wsnmp32.dll |