Función SnmpMgrTrapListen (mgmtapi.h)
[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
La función SnmpMgrTrapListen registra la capacidad de una aplicación de administrador snmp para recibir capturas SNMP del servicio de captura de SNMP. Esta función es un elemento de la API de administración de SNMP.
Sintaxis
BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
[out] HANDLE *phTrapAvailable
);
Parámetros
[out] phTrapAvailable
Puntero a un controlador de eventos para recibir una indicación de que hay capturas disponibles y que la aplicación debe llamar a la función SnmpMgrGetTrap .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError, que puede devolver cualquiera de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Indica un error de asignación de memoria. |
|
Indica que ya se ha llamado a esta función. |
|
Indica que se han producido uno o varios errores; Las trampas no son accesibles. La aplicación puede intentar llamar a la función de nuevo. |
Esta función también puede devolver otros errores del sistema.
Comentarios
Es importante tener en cuenta que para los usuarios que no son administradores, la función SnmpMgrTrapListen solo se realiza correctamente si se ha iniciado el servicio de captura de SNMP.
La aplicación siempre debe llamar a la función SnmpMgrTrapListen antes de llamar a la función SnmpMgrGetTrap . Esto se debe a que el identificador de eventos al que apunta el parámetro phTrapAvailable permite la adquisición controlada por eventos de capturas SNMP. Snmp Management API señala el evento de una aplicación cuando el servicio de captura snmp entrega una captura.
La aplicación también puede sondear la función SnmpMgrGetTrap para capturas a intervalos regulares. En este caso, la aplicación debe llamar repetidamente a SnmpMgrGetTrap hasta que la función devuelva cero.
Windows Server 2003: Las aplicaciones de administrador snmp pueden llamar a SnmpMgrClose con un parámetro de sesiónNULL para limpiar los recursos asociados a una llamada correcta a la función SnmpMgrTrapListen. Sin embargo, tenga en cuenta que si la aplicación es un archivo DLL, no debe llamar a SnmpMgrClose desde su función de punto de entrada DllMain .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mgmtapi.h |
| Library | Mgmtapi.lib |
| Archivo DLL | Mgmtapi.dll |
Consulte también
Introducción al Protocolo simple de administración de redes (SNMP)