Définition du mode de traduction d’entité et de contexte
L’application WinSNMP peut spécifier l’interprétation et la traduction des paramètres d’entité et de contexte en définissant le mode de traduction de l’entité et du contexte. L’implémentation De Microsoft WinSNMP stocke le mode dans une base de données.
Le paramètre du mode de traduction d’entité et de contexte détermine la façon dont les fonctions SnmpStrToEntity et SnmpStrToContext interprètent les chaînes d’entrée. Le paramètre détermine également le type de chaîne de sortie que les fonctions SnmpEntityToStr et SnmpContextToStr retournent. Pour plus d’informations, consultez Prise en charge des chaînes d’adresses IPX dans WinSNMP.
L’implémentation retourne l’entité par défaut actuelle et le mode de traduction de contexte dans le paramètre nTranslateMode de la fonction SnmpStartup . Pour récupérer l’entité actuelle et le mode de traduction de contexte en vigueur pour l’implémentation, une application peut appeler la fonction SnmpGetTranslateMode à tout moment.
Les modes de traduction d’entité et de contexte valides sont les suivants.
| Mode | Signification |
|---|---|
| SNMPAPI_TRANSLATED | L’implémentation utilise sa base de données pour traduire des noms conviviaux pour les entités SNMP et les objets managés. L’implémentation les traduit en composants SNMPv1 ou SNMPv2C. |
| SNMPAPI_UNTRANSLATED_V1 | L’implémentation interprète les paramètres d’entité SNMP comme des adresses de transport SNMP littérales et les paramètres de contexte en tant que chaînes de communauté SNMP littérales. Pour les entités de destination SNMPv2, l’implémentation crée des messages SNMP sortants qui contiennent une valeur zéro dans le champ de version. |
| SNMPAPI_UNTRANSLATED_V2 | L’implémentation interprète les paramètres d’entité SNMP comme des adresses de transport SNMP et les paramètres de contexte comme des chaînes de communauté SNMP littérales. Pour les entités de destination SNMPv2, l’implémentation crée des messages SNMP sortants qui contiennent la valeur 1 dans le champ de version. |
L’implémentation tente d’associer des ressources dans sa base de données à l’adresse de transport littérale de l’entité de gestion.
Pour modifier le paramètre de mode de traduction d’entité et de contexte, une application WinSNMP doit appeler la fonction SnmpSetTranslateMode . Si le mode de traduction demandé n’est pas valide, la fonction échoue et SnmpGetLastError retourne le code d’erreur SNMPAPI_MODE_INVALID.