Функция SnmpMgrTrapListen (mgmtapi.h)

Статья
08/24/2023

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

Функция SnmpMgrTrapListen регистрирует возможность приложения диспетчера SNMP получать ловушки SNMP из службы SNMP Trap. Эта функция является элементом API управления SNMP.

Синтаксис

BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
  [out] HANDLE *phTrapAvailable
);

Параметры

[out] phTrapAvailable

Указатель на дескриптор события для получения указания о наличии доступных ловушек и о том, что приложение должно вызывать функцию SnmpMgrGetTrap .

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

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

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

Код возврата	Описание
SNMP_MEM_ALLOC_ERROR	Указывает на ошибку выделения памяти.
SNMP_MGMTAPI_TRAP_DUPINIT	Указывает, что эта функция уже была вызвана.
SNMP_MGMTAPI_TRAP_ERRORS	Указывает, что произошла одна или несколько ошибок; ловушки недоступны. Приложение может попытаться снова вызвать функцию.

Эта функция также может возвращать другие системные ошибки.

Приложение должно всегда вызывать функцию SnmpMgrTrapListen перед вызовом функции SnmpMgrGetTrap . Это связано с тем, что дескриптор событий, на который указывает параметр phTrapAvailable , позволяет получать SNMP-ловушки на основе событий. API управления SNMP сигнализирует о событии приложения, когда служба SNMP-ловушки предоставляет ловушку.

Приложение также может опрашивает функцию SnmpMgrGetTrap на наличие ловушек через регулярные интервалы. В этом случае приложение должно повторно вызывать SnmpMgrGetTrap , пока функция не вернет ноль.

Windows Server 2003: Приложения диспетчера SNMP могут вызывать SnmpMgrClose с параметром сеансаNULL для очистки ресурсов, связанных с успешным вызовом функции SnmpMgrTrapListen. Однако обратите внимание, что если приложение является библиотекой DLL, оно не должно вызывать SnmpMgrClose из своей функции точки входа DllMain .

Требования

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

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

Функции SNMP

Обзор протокола SNMP

SnmpMgrGetTrap

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