На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SnmpMgrTrapListen



The SnmpMgrTrapListen function registers the ability of a manager application to receive SNMP traps.

BOOL SnmpMgrTrapListen(

HANDLE *phTrapAvailable // event handle indicating trap(s) available
);


Parameters

phTrapAvailable

[out] Points to an event handle that will be used to indicate that there are traps available, and that the application should call the SnmpMgrGetTrap function.



Return Values

If the function succeeds, the return value is TRUE.
If the function fails, the return value is FALSE. To get extended error information, call GetLastError. GetLastError may return any of the following error codes:

Error Code Description
SNMP_MEM_ALLOC_ERROR Indicates a memory allocation error.
SNMP_MGMTAPI_TRAP_DUPINIT Indicates that this function has already been called.
SNMP_MGMTAPI_AGAIN Indicates an error occurred; the application can attempt to call the function again.


This function may return other system errors as well.

Remarks

It is important to note that the SnmpMgrTrapListen function succeeds on Windows NT 4.0 only if the SNMP Trap Service has been started. See Turning SNMP On and Off for additional information.
The event that the phTrapAvailable parameter points to allows event-driven acquisition of SNMP traps. If you call the SnmpMgrTrapListen function first, you can ignore the event handle and poll the SnmpMgrGetTrap function for traps at regular intervals instead.

Another method to acquire traps is to create a thread to wait on the event using the WaitForSingleObject function. When the call initiates an event, the thread should clear the event using the ResetEvent function. Then the thread should repeatedly call the SnmpMgrGetTrap function until it returns a value of FALSE.
Always call the SnmpMgrTrapListen function before calling SnmpMgrGetTrap to receive traps. If an SNMP manager application calls SnmpMgrGetTrap first to receive traps, it returns a value of FALSE, even if there are traps available. If the application calls GetLastError before calling SnmpMgrTrapListen, GetLastError returns the error code SNMP_MGMTAPI_TRAP_ERRORS.

See Also

SnmpMgrGetTrap, WaitForSingleObject, ResetEvent


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SnmpMgrTrapListen



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

BOOL SnmpMgrTrapListen(

РУЧКА *ручка случая phTrapAvailable //, указывающая ловушку(s) доступный
);


Параметры

phTrapAvailable

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



Обратные Величины

Если функция добивается успеха, обратная величина является ИСТИНОЙ.
Если функция терпит неудачу, обратная величина ЛОЖНАЯ. Для того, чтобы расширять информацию ошибки, назовите GetLastError. GetLastError МОЖЕТ возвращать любой из следующих кодов ошибки:

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


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

Замечания

Важно должно отмечать, что функция SnmpMgrTrapListen добивается успеха на Windows NT 4.0 только если Услуга Прерывания SNMP запущена. Смотри Поворот SNMP На и для дополнительной информации.
Событие, что параметр phTrapAvailable указывает, чтобы допускать управляемое приобретение события прерываний SNMP. Если Вы называете функцию SnmpMgrTrapListen сначала, Вы можете проигнорировать ручку события и опрашивать функцию SnmpMgrGetTrap для прерываний в регулярных интервалах взамен.

Другой метод, чтобы приобретать прерывания - создавать резьбу, чтобы ожидаться в событии, использовавшем функцию WaitForSingleObject. Когда вызов вводит событие, резьба должна очищать событие, использовавшее функцию ResetEvent. Затем резьба должна многократно называть функцию SnmpMgrGetTrap пока она не возвращает величину ЛЖИ.
Всегда назовите функцию SnmpMgrTrapListen перед вызовом SnmpMgrGetTrap, чтобы получать прерывания. Если приложение менеджера SNMP называет SnmpMgrGetTrap сначала, чтобы получать прерывания, оно возвращает величину ЛЖИ, даже если бы есть прерывания доступные. Если приложение называет GetLastError перед вызовом SnmpMgrTrapListen, GetLastError возвращает код ошибки SNMP_MGMTAPI_TRAP_ERRORS.

Смотри Также

SnmpMgrGetTrap, WaitForSingleObject, ResetEvent


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz