Fonction SnmpExtensionMonitor (snmp.h)

Article
08/26/2023

[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]

Le service SNMP Microsoft appelle la fonction SnmpExtensionMonitor pour fournir à l’agent d’extension SNMP une vue des compteurs et paramètres internes du service. Cette fonction est un élément de l’API de l’agent d’extension SNMP.

La fonction SnmpExtensionMonitor est facultative. Les agents d’extension doivent implémenter la fonction s’ils sont intéressés par une vue des objets de gestion interne du service SNMP, comme défini dans la RFC 1213, « Base d’informations de gestion pour la gestion du réseau des internets TCP/IP : MIB-II ».

Syntaxe

BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
  [in] LPVOID pAgentMgmtData
);

Paramètres

[in] pAgentMgmtData

Pointeur vers un tableau d’objets AsnAny (structures). Le nombre d’objets, ainsi que le type et la description de chaque objet, sont conformes à la RFC 1213. Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

À moins qu’une erreur inattendue ne se produise pendant que l’agent d’extension SNMP traite la valeur du paramètre pAgentMgmtData , l’agent d’extension doit retourner TRUE. Si l’agent d’extension retourne FALSE, le service SNMP ne charge pas l’agent d’extension et le service cesse de diriger les requêtes SNMP vers l’agent d’extension.

Remarques

Si l’agent d’extension exporte la fonction SnmpExtensionMonitor , le service SNMP appelle la fonction pendant l’initialisation de l’agent d’extension, immédiatement après que le service a appelé les fonctions SnmpExtensionInit et SnmpExtensionInitEx .

Le service SNMP met à jour dynamiquement les compteurs SNMP (par exemple, les compteurs snmpInPkts et snmpOutNoSuchNames) dans le tableau vers lequel pointe le paramètre pAgentMgmtData . Pour pouvoir lire ces valeurs pendant l’exécution du service SNMP, l’agent d’extension doit stocker le pointeur vers pAgentMgmtData.

Notez qu’un agent d’extension SNMP ne doit pas mettre à jour la mémoire pointée par le paramètre pAgentMgmtData . En effet, les valeurs des compteurs internes du service SNMP ne sont plus valides et le comportement du service SNMP peut devenir imprévisible. Tant que l’agent d’extension ne le modifie pas, la mémoire pointée par pAgentMgmtData est valide pendant l’exécution du service SNMP.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	snmp.h