Fonctions SNMP
[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt gestion à distance Windows, 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 d’API de l’agent d’extension SNMP
- fonctions d’API de gestion SNMP
- fonctions d’API de l’utilitaire SNMP
Fonctions d’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 tierces. 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 à l’agent d’extension SNMP de libérer des ressources et d’arrêter les opérations. |
SnmpExtensionInit | Initialise la DLL de l’agent d’extension SNMP. |
SnmpExtensionInitEx | Identifie les sous-arborescences de base d’informations de gestion supplémentaires prises en charge par l’agent d’extension SNMP. |
SnmpExtensionMonitor | Fournit à l’agent d’extension SNMP des informations sur les compteurs internes et les paramètres du service. |
snmpExtensionQuery | Résout les requêtes SNMP qui contiennent des variables dans une ou plusieurs 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 les 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 gestion SNMP
Les fonctions de gestion SNMP définissent l’interface entre les applications de gestionnaire SNMP tierces et la bibliothèque de liaison dynamique de fonction de gestion (DLL) 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 utilisées par les applications de gestionnaire tierces pour effectuer des opérations SNMP Manager.
Fonction 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 communautaire 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 nécessaires 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 à partir du service d’interruption SNMP. |
Fonctions d’API de l’utilitaire SNMP
Les fonctions de l’utilitaire SNMP fournissent des fonctionnalités utiles pendant le développement d’applications SNMP, notamment la simplification de la manipulation des structures de données SNMP. Le tableau suivant répertorie les fonctions de l’utilitaire SNMP.
Fonction d’API de l’utilitaire SNMP | Description |
---|---|
SnmpSvcGetUptime | Récupère l’heure, en centisecondes, pour laquelle le service SNMP est en cours d’exécution. |
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 de 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 pour 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 structureAsnOctetString source vers une structure AsnOctetString de destination. |
SnmpUtilOctetsFree | Libère la mémoire allouée pour la chaîne d’octets spécifiée. |
SnmpUtilOctetsNCmp | Effectue une comparaison de deux chaînes d’octets au 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 deAsnObjectIdentifiersource dans 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 AsnObjectIdentifier structures 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 spécifié (OID) et imprime le résultat sur l’appareil de sortie standard. |
SnmpUtilVarBindCpy | Copie une structure deSnmpVarBindsource vers une structure SnmpVarBind de destination. |
snmpUtilVarBindListCpy | Copie une structure deSnmpVarBindListsource vers une structure SnmpVarBindList de destination. |
SnmpUtilVarBindFree | Libère la mémoire allouée pour la structure SnmpVarBind spécifiée. |
SnmpUtilVarBindListFree | Libère la mémoire allouée pour la structure SnmpVarBindList spécifiée. |