Fonctions SNMP
[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
- Fonctions de l’API de gestion SNMP
- Fonctions de l’API de l’utilitaire SNMP
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. |