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
SNMP_MEM_ALLOC_ERROR	Indica un error de asignación de memoria.
SNMP_MGMTAPI_TRAP_DUPINIT	Indica que ya se ha llamado a esta función.
SNMP_MGMTAPI_TRAP_ERRORS	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

Funciones SNMP

Introducción al Protocolo simple de administración de redes (SNMP)

SnmpMgrGetTrap