Registros de captura múltiple

Hay varias opciones disponibles cuando una aplicación WinSNMP registra una sesión de WinSNMP para capturas o notificaciones. Debido a esto, una aplicación puede llamar a la función SnmpRegister varias veces, en efecto definiendo un filtro personalizado para la recepción de capturas y notificaciones. Por ejemplo, puede registrarse para un tipo de captura o notificación, o para todas las capturas y notificaciones, en función del valor de la notificación de parámetro. Además, la aplicación puede especificar valores en otros parámetros para la función SnmpRegister para definir aún más las capturas y las notificaciones que deben llegar a una aplicación. Para obtener más información, consulte Administración de capturas y notificaciones.

A continuación se muestran instancias en las que varias llamadas a SnmpRegister son redundantes. En estas instancias, SnmpRegister devuelve SNMPAPI_SUCCESS si la función se completa correctamente, pero el registro redundante no es eficaz.

1. Una llamada al función SnmpRegister que solicita la entrega filtrada de capturas y notificaciones a la sesión, después de una llamada anterior a SnmpRegister solicitar la entrega de todas las capturas y notificaciones (entrega sin filtrar). Esta llamada es redundante porque la sesión ya recibe todas las capturas y notificaciones, incluido el tipo único definido por el filtro.
2. Una llamada duplicada a SnmpRegister, o una en la que la lista de parámetros es idéntica a la lista de parámetros de una llamada anterior a SnmpRegister para la sesión.
3. Una llamada al función SnmpRegister que solicita la entrega filtrada de capturas y notificaciones basadas en un identificador de objeto (OID) cuyo prefijo es un OID especificado en una llamada anterior a SnmpRegister. Por ejemplo, puede especificar "1.3.6.1.4.1.311" en el parámetro notificación para recibir notificaciones procedentes de cualquier entidad del agente SNMP de Microsoft. Si llama a SnmpRegister de nuevo y especifica "1.3.6.1.4.1.311.1", la segunda llamada es redundante porque la sesión ya recibe todas las capturas y notificaciones que contienen el prefijo OID "1.3.6.1.4.1.311".

Para anular el registro de la sesión, debe coincidir con cada llamada de registro única a la función SnmpRegister. Llame a SnmpRegister para anular el registro de la sesión y asegúrese de que los cinco primeros parámetros para snmpRegister sean idénticos a los de la llamada de registro inicial. La única diferencia entre la llamada inicial y la llamada sin registrar es que, al registrar, debe especificar el valor SNMPAPI_ON en el parámetro de estado de y, al llamar a la función para anular el registro, debe especificar SNMPAPI_OFF. No es necesario que coincidan las llamadas de registro redundantes a la función snmpRegister de. Solo necesita coincidir con la primera llamada de registro única.

Para cambiar los criterios de filtrado, puede ser necesario que una aplicación anule primero el registro y deshabilite la entrega de determinadas capturas o notificaciones. A continuación, la aplicación puede crear un nuevo filtro llamando a SnmpRegister, pasando los valores adecuados.