Fonctions SNMP

  • Article

[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. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]

Cette rubrique décrit trois regroupements de fonctions SNMP et répertorie les fonctions incluses dans chaque groupe :

Fonctions de l’API de l’agent d’extension SNMP

Les fonctions de l’agent d’extension SNMP définissent l’interface entre le service SNMP et les DLL de l’agent d’extension SNMP tiers. Le tableau suivant répertorie les fonctions que les applications peuvent utiliser pour résoudre les liaisons de variables spécifiées par les unités de données de protocole SNMP entrantes.

Fonction API de l’agent d’extension SNMP Description
SnmpExtensionClose Demande que l’agent d’extension SNMP libère les ressources et arrête les opérations.
SnmpExtensionInit Initialise la DLL de l’agent d’extension SNMP.
SnmpExtensionInitEx Identifie toutes les sous-arborescences MIB (Management Information Base) supplémentaires que l’agent d’extension SNMP prend en charge.
SnmpExtensionMonitor Fournit à l’agent d’extension SNMP des informations sur les compteurs et paramètres internes du service.
SnmpExtensionQuery Résout les requêtes SNMP qui contiennent des variables dans une ou plusieurs des sous-arborescences MIB inscrites de l’agent d’extension SNMP.
SnmpExtensionQueryEx Traite les requêtes SNMP qui spécifient des variables dans une ou plusieurs sous-arborescences MIB inscrites par des agents d’extension SNMP.
SnmpExtensionTrap Récupère les informations dont le service a besoin pour générer des interruptions pour l’agent d’extension SNMP.

 

Fonctions de l’API de gestion SNMP

Les fonctions de gestion SNMP définissent l’interface entre les applications de gestionnaire SNMP tierces et la bibliothèque de liens dynamiques (DLL) de la fonction de gestion Mgmtapi.dll. La DLL fonctionne conjointement avec le service d’interruption SNMP (Snmptrap.exe) et peut interagir avec une ou plusieurs applications de gestionnaire SNMP tierces. Le tableau suivant répertorie les fonctions de gestion que les applications de gestionnaire tierces utilisent pour effectuer des opérations de gestionnaire SNMP.

Fonction de l’API de gestion SNMP Description
SnmpMgrClose Ferme les sockets de communication et les structures de données associés à la session spécifiée.
SnmpMgrCtl Définit un paramètre d’exploitation associé à une session SNMP.
SnmpMgrGetTrap Retourne les données d’interruption en attente que l’appelant n’a pas reçues si la réception d’interruption est activée.
SnmpMgrGetTrapEx Retourne les données d’interruption en attente que l’appelant n’a pas reçues si la réception d’interruption est activée. Retourne également l’adresse de la source de transport et du piège de la communauté associé au piège.
SnmpMgrOidToStr Convertit une structure d’identificateur d’objet interne en sa représentation sous forme de chaîne.
SnmpMgrOpen Initialise les sockets de communication et les structures de données requis pour établir la communication avec l’agent SNMP.
SnmpMgrRequest Demande que l’opération spécifiée soit effectuée par l’agent spécifié.
SnmpMgrStrToOid Convertit le format de chaîne d’un identificateur d’objet en sa structure d’identificateur d’objet interne.
SnmpMgrTrapListen Inscrit la capacité d’une application de gestionnaire SNMP à recevoir des interruptions SNMP du service d’interruption SNMP.

 

Fonctions de l’API de l’utilitaire SNMP

Les fonctions utilitaires SNMP fournissent des fonctionnalités utiles lors du développement d’applications SNMP, notamment la simplification de la manipulation des structures de données SNMP. Le tableau suivant répertorie les fonctions utilitaires SNMP.

Fonction d’API de l’utilitaire SNMP Description
SnmpSvcGetUptime Récupère l’heure, en centisecondes, pendant laquelle le service SNMP a été exécuté.
SnmpSvcSetLogLevel Ajuste le niveau de détail de la sortie de débogage du service SNMP et des agents d’extension SNMP.
SnmpSvcSetLogType Ajuste la destination pour la sortie de débogage du service SNMP et des agents d’extension SNMP.
SnmpUtilAsnAnyCpy Copie une structure AsnAny source vers une structure AsnAny de destination.
SnmpUtilAsnAnyFree Libère la mémoire allouée à une structure AsnAny spécifiée.
SnmpUtilDbgPrint Définit le niveau d’informations de débogage à recevoir du service SNMP ou d’un appel à SnmpUtilDbgPrint.
SnmpUtilIdsToA Convertit un identificateur d’objet (OID) en chaîne terminée par null.
SnmpUtilMemAlloc Alloue de la mémoire dynamique à partir du tas de processus.
SnmpUtilMemFree Libère l’objet mémoire spécifié.
SnmpUtilMemReAlloc Modifie la taille de l’objet mémoire spécifié.
SnmpUtilOctetsCmp Compare deux chaînes d’octets.
SnmpUtilOctetsCpy Copie une structure AsnOctetString source vers une structure AsnOctetString de destination.
SnmpUtilOctetsFree Libère la mémoire allouée pour la chaîne d’octet spécifiée.
SnmpUtilOctetsNCmp Effectue une comparaison de deux chaînes d’octets avec le nombre spécifié de sous-identificateurs.
SnmpUtilOidAppend Ajoute un identificateur d’objet source, contenu dans une structure AsnObjectIdentifier , à un identificateur d’objet de destination.
SnmpUtilOidCmp Compare deux identificateurs d’objet contenus dans les structures AsnObjectIdentifier .
SnmpUtilOidCpy Copie une structure AsnObjectIdentifier source vers une structure AsnObjectIdentifier de destination.
SnmpUtilOidFree Libère la mémoire allouée pour l’identificateur d’objet spécifié.
SnmpUtilOidNCmp Compare deux identificateurs d’objet contenus dans les structures AsnObjectIdentifier au nombre spécifié de sous-identificateurs.
SnmpUtilOidToA Convertit un identificateur d’objet (OID) en chaîne terminée par null.
SnmpUtilPrintAsnAny Imprime une valeur contenue dans une structure AsnAny à des fins de débogage et de développement.
SnmpUtilPrintOid Met en forme l’identificateur d’objet (OID) spécifié et imprime le résultat sur l’appareil de sortie standard.
SnmpUtilVarBindCpy Copie une structure SnmpVarBind source vers une structure SnmpVarBind de destination.
SnmpUtilVarBindListCpy Copie une structure SnmpVarBindList source vers une structure SnmpVarBindList de destination.
SnmpUtilVarBindFree Libère la mémoire allouée à la structure SnmpVarBind spécifiée.
SnmpUtilVarBindListFree Libère la mémoire allouée à la structure SnmpVarBindList spécifiée.