Partager via

Fonctions WinSNMP

  • Article

[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.]

Les fonctions utilisées avec WinSNMP entrent dans les regroupements fonctionnels suivants. Une liste alphabétique suit.

Fonctions de communication WinSNMP

Les fonctions de communication WinSNMP fournissent une interface entre l’application WinSNMP appelante et l’implémentation de Microsoft WinSNMP. L’implémentation gère la communication entre l’application et d’autres entités de gestion.

Fonction Description
SnmpCancelMsg Demande que l’implémentation de Microsoft WinSNMP annule les tentatives de retransmission et les notifications de délai d’attente pour un message de demande SNMP.
snmpCleanup Informe l’implémentation qu’une application se déconnecte et ne nécessite plus de ressources allouées.
SnmpCleanupEx Effectue le nettoyage en cas d’absence d’appels réussis pour SnmpStartup ou SnmpStartupEx au sein d’une application WinSNMP.
snmpClose Permet à l’implémentation de libérer des ressources associées à une session et de fermer les mécanismes de communication.
SnmpCreateSession Demande à l’implémentation d’ouvrir une session WinSNMP et d’allouer des ressources et des mécanismes de communication. Lors du développement de nouvelles applications WinSNMP, il est recommandé d’appeler la fonction SnmpCreateSession pour ouvrir une session WinSNMP au lieu d’appeler la fonction SnmpOpen.
snmpListen Inscrit ou annule l’inscription d’une application WinSNMP en tant qu’agent SNMP.
SnmpOpen Demande à l’implémentation d’ouvrir une session WinSNMP et d’allouer des ressources et des mécanismes de communication. Lors du développement de nouvelles applications WinSNMP, il est recommandé d’appeler la fonction SnmpCreateSession pour ouvrir une session WinSNMP au lieu d’appeler la fonction SnmpOpen.
snmpRecvMsg Retourne les messages SNMP et les données et notifications d’interruption en attente.
SnmpRegister Informe l’implémentation que l’application doit inscrire ou annuler l’inscription pour les interruptions et les notifications.
SnmpSendMsg Demande que l’implémentation transmette une unité de données de protocole.
snmpStartup Avertit l’implémentation d’effectuer des procédures d’initialisation pour l’application. Une application doit appeler la fonction SnmpStartup correctement avant d’appeler une autre fonction WinSNMP.
SnmpStartupEx Avertit l’implémentation De Microsoft WinSNMP que l’application WinSNMP nécessite les services de l’implémentation. SnmpStartupEx permet la prise en charge de plusieurs modules logiciels indépendants qui utilisent WinSNMP dans la même application.
SNMPAPI_CALLBACK Avertit une session WinSNMP qu’un message SNMP ou un événement asynchrone est disponible. Remarque : cette fonction de rappel s’applique uniquement aux sessions ouvertes à la suite d’un appel à la fonction SnmpCreateSession.

Fonctions d’entité et de contexte WinSNMP

Les fonctions d’entité et de contexte WinSNMP permettent à une application WinSNMP de spécifier des noms conviviaux pour les entités et contextes SNMP. L’implémentation De Microsoft WinSNMP traduit le nom en ses composants SNMPv1 ou SNMPv2C à l’aide de la base de données de l’implémentation.

Fonction Description
SnmpContextToStr Retourne une chaîne qui identifie un contexte SNMP (un ensemble de ressources d’objet managé).
SnmpEntityToStr Retourne une chaîne qui identifie une entité de gestion SNMP.
SnmpFreeContext Libère les ressources allouées par la fonction SnmpStrToContext pour un contexte SNMP.
SnmpFreeEntity Libère les ressources allouées par la fonction SnmpStrToEntity pour une entité de gestion SNMP.
snmpSetPort Modifie le port affecté à une entité de destination SNMP.
SnmpStrToContext Retourne un handle aux informations de contexte SNMP spécifiques à l’implémentation.
SnmpStrToEntity Retourne un handle aux informations d’entité de gestion SNMP spécifiques à l’implémentation.

Fonctions de base de données WinSNMP

Les fonctions de base de données WinSNMP fournissent une application WinSNMP avec accès aux paramètres actuels dans le magasin d’informations d’administration de l’implémentation De Microsoft WinSNMP. Ces fonctions permettent de modifier le mode de retransmission et l’entité et le mode de traduction de contexte. Les fonctions de base de données fournissent également à l’application la possibilité de manipuler les valeurs de délai d’attente et de nombre de nouvelles tentatives.

Fonction Description
SnmpGetRetransmitMode Retourne le paramètre actuel du mode de retransmission.
SnmpGetRetry Retourne la valeur de nombre de nouvelles tentatives, en unités, pour la retransmission des demandes de message SNMP.
snmpGetTimeout Retourne la valeur de délai d’attente, en centièmes de seconde, pour la transmission des demandes de message SNMP.
SnmpGetTranslateMode Retourne le paramètre actuel de l’entité et du mode de traduction de contexte.
snmpGetVendorInfo Récupère des informations qui identifient le fournisseur WinSNMP.
SnmpSetRetransmitMode Modifie le mode de retransmission.
snmpSetRetry Modifie la valeur de nombre de nouvelles tentatives pour la retransmission des demandes de message SNMP.
snmpSetTimeout Modifie la valeur de délai d’attente pour la transmission des demandes de message SNMP.
SnmpSetTranslateMode Modifie le mode de traduction d’entité et de contexte.

Fonctions PDU WinSNMP

Les fonctions PDU WinSNMP permettent aux applications WinSNMP d’extraire et de mettre à jour les éléments de données (ou champs) d’un PDU. Cela inclut les pdus retournés par un appel à la fonction SnmpRecvMsg ou à la fonction SnmpDecodeMsg. Les fonctions PDU construisent également des PDU à utiliser dans les fonctions SnmpSendMsg et SnmpEncodeMsg.

Fonction Description
SnmpCreatePdu Crée et initialise une unité de données de protocole SNMP.
SnmpDuplicatePdu Dupliquer une unité de données de protocole SNMP.
SnmpFreePdu Libère les ressources associées à une unité de données de protocole SNMP créée par la SnmpCreatePdu ou la fonction SnmpDuplicatePdu.
snmpGetPduData Retourne les éléments de données sélectionnés à partir d’une unité de données de protocole SNMP spécifiée.
SnmpSetPduData Met à jour les éléments de données sélectionnés dans une unité de données de protocole SNMP spécifiée.

Fonctions de l’utilitaire WinSNMP

Les fonctions de l’utilitaire WinSNMP permettent à une application WinSNMP de gérer des objets et des messages SNMP sur l’interface WinSNMP.

Fonction Description
SnmpDecodeMsg Décode un message SNMP encodé ou sérialisé dans ses composants constituants.
SnmpEncodeMsg Crée un message SNMP encodé.
snmpFreeDescriptor Signale à l’implémentation De Microsoft WinSNMP qu’elle doit libérer la mémoire allouée pour un descripteur spécifique.
SnmpGetLastError Retourne la dernière valeur de code d’erreur pour la dernière opération SNMP.
SnmpOidCompare Compare deux identificateurs d’objet SNMP.
SnmpOidCopy Copie un identificateur d’objet SNMP.
SnmpOidToStr Convertit la représentation binaire interne d’un identificateur d’objet SNMP en son format de chaîne numérique en pointillés.
SnmpStrToOid Convertit le format de chaîne numérique en pointillé d’un identificateur d’objet SNMP en sa représentation binaire interne.

Fonctions de liaison de variable WinSNMP

Les fonctions de liaison de variables WinSNMP permettent aux applications WinSNMP de construire et de manipuler des listes de liaisons de variables, et de les inclure dans des PDU.

Fonction Description
snmpCountVbl Énumère les entrées de liaison de variable dans une liste de liaisons de variables spécifiée.
SnmpCreateVbl Crée une liste de liaisons de variable.
SnmpDeleteVb Supprime une entrée de liaison de variable d’une liste de liaisons de variables.
SnmpDuplicateVbl Copie une liste de liaisons de variables.
snmpFreeVbl Libère les ressources d’une liste de liaisons de variables allouée précédemment par leSnmpCreateVblou la fonction SnmpDuplicateVbl.
snmpGetVb Récupère des informations à partir d’une entrée de liaison de variable spécifiée.
snmpSetVb Modifie les entrées de liaison de variable dans une liste de liaisons de variables ; ajoute de nouvelles entrées de liaison de variable à une liste de liaisons de variables existante.

Liste alphabétique des fonctions WinSNMP