Fonction SnmpSetTranslateMode (winsnmp.h)

Article
03/13/2024

[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. Au lieu de cela, utilisez La gestion à distance Windows, qui est l’implémentation Microsoft de WS-Man.]

La fonction SnmpSetTranslateMode WinSNMP permet à une application WinSNMP de modifier le mode de traduction d’entité et de contexte. Le mode de traduction d’entité et de contexte affecte l’interprétation et le retour des paramètres d’entrée et de chaîne de sortie WinSNMP.

Syntaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

Paramètres

[in] nTranslateMode

Spécifie une valeur pour le nouveau mode de traduction d’entité et de contexte. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SNMPAPI_TRANSLATED	L’implémentation de Microsoft WinSNMP 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 et les paramètres de contexte comme des chaînes de communauté SNMP. Pour les entités de destination SNMPv2, l’implémentation crée des messages SNMP sortants qui contiennent la 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. 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.

Valeur retournée

Si la fonction réussit, la valeur de retour est SNMPAPI_SUCCESS.

Si la fonction échoue, la valeur de retour est SNMPAPI_FAILURE. Pour obtenir des informations d’erreur étendues, appelez SnmpGetLastError en spécifiant une valeur NULL dans son paramètre de session . La fonction SnmpGetLastError peut retourner l’une des erreurs suivantes.

Code de retour	Description
SNMPAPI_NOT_INITIALIZED	La fonction SnmpStartup ne s’est pas terminée correctement.
SNMPAPI_ALLOC_ERROR	Une erreur s’est produite lors de l’allocation de mémoire.
SNMPAPI_MODE_INVALID	L’implémentation ne prend pas en charge le mode de traduction demandé.
SNMPAPI_OTHER_ERROR	Une erreur inconnue ou non définie s’est produite.

Remarques

Le nouveau mode de traduction d’entité et de contexte affecte les appels suivants aux fonctions SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr et SnmpEntityToStr . L’application WinSNMP peut à nouveau modifier le mode de traduction d’entité et de contexte en effectuant un autre appel à SnmpSetTranslateMode avec une valeur nTranslateMode différente.

Pour plus d’informations, consultez Définition du mode de traduction d’entité et de contexte.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsnmp.h
Bibliothèque	Wsnmp32.lib
DLL	Wsnmp32.dll