Función SnmpExtensionMonitor (snmp.h)

Artículo
03/15/2023

[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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

El servicio SNMP de Microsoft llama a la función SnmpExtensionMonitor para proporcionar al agente de extensión SNMP una vista de los parámetros y contadores internos del servicio. Esta función es un elemento de la API del Agente de extensión SNMP.

La función SnmpExtensionMonitor es opcional. Los agentes de extensión deben implementar la función si están interesados en una vista de los objetos de administración interna del servicio SNMP, tal como se define en RFC 1213, "Base de información de administración para la administración de redes de Internets basadas en TCP/IP: MIB-II".

Sintaxis

BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
  [in] LPVOID pAgentMgmtData
);

Parámetros

[in] pAgentMgmtData

Puntero a una matriz de objetos AsnAny (estructuras). El número de objetos y el tipo y la descripción de cada objeto se ajustan a RFC 1213. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

A menos que se produzca un error inesperado mientras el agente de extensión SNMP está procesando el valor del parámetro pAgentMgmtData , el agente de extensión debe devolver TRUE. Si el agente de extensión devuelve FALSE, el servicio SNMP no carga el agente de extensión y el servicio deja de dirigir las solicitudes SNMP al agente de extensión.

Comentarios

Si el agente de extensión exporta la función SnmpExtensionMonitor , el servicio SNMP llama a la función durante la inicialización del agente de extensión, inmediatamente después de que el servicio llame a las funciones SnmpExtensionInit y SnmpExtensionInitEx .

El servicio SNMP actualiza dinámicamente los contadores SNMP (por ejemplo, snmpInPkts y los contadores snmpOutNoSuchNames) de la matriz a la que apunta el parámetro pAgentMgmtData . Para poder leer estos valores mientras se ejecuta el servicio SNMP, el agente de extensión debe almacenar el puntero a pAgentMgmtData.

Tenga en cuenta que un agente de extensión SNMP no debe actualizar la memoria a la que apunta el parámetro pAgentMgmtData . Esto se debe a que los valores de los contadores internos del servicio SNMP ya no serían válidos y el comportamiento del servicio SNMP podría ser impredecible. Siempre que el agente de extensión no lo modifique, la memoria a la que apunta pAgentMgmtData es válida mientras se ejecuta el servicio SNMP.

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	snmp.h