Establecer el modo de traducción de entidad y contexto
La aplicación WinSNMP puede especificar la interpretación y traducción de parámetros de entidad y contexto estableciendo el modo de traducción de entidad y contexto. La implementación de Microsoft WinSNMP almacena el modo en una base de datos.
La configuración del modo de traducción de entidad y contexto determina la manera en que la función SnmpStrToEntity y la función SnmpStrToContext interpretan las cadenas de entrada. La configuración también determina el tipo de cadena de salida que devuelven las funciones SnmpEntityToStr y SnmpContextToStr . Para obtener más información, vea Compatibilidad con cadenas de dirección IPX en WinSNMP.
La implementación devuelve la entidad predeterminada actual y el modo de traducción de contexto en el parámetro nTranslateMode de la función SnmpStartup . Para recuperar la entidad actual y el modo de traducción de contexto en vigor para la implementación, una aplicación puede llamar a la función SnmpGetTranslateMode en cualquier momento.
A continuación se siguen los modos válidos de traducción de entidades y contextos.
| Mode | Significado |
|---|---|
| SNMPAPI_TRANSLATED | La implementación usa su base de datos para traducir nombres descriptivos para entidades SNMP y objetos administrados. La implementación los traduce en sus componentes SNMPv1 o SNMPv2C. |
| SNMPAPI_UNTRANSLATED_V1 | La implementación interpreta los parámetros de entidad SNMP como direcciones de transporte SNMP literales y parámetros de contexto como cadenas de comunidad SNMP literales. En el caso de las entidades de destino SNMPv2, la implementación crea mensajes SNMP salientes que contienen un valor de cero en el campo de versión. |
| SNMPAPI_UNTRANSLATED_V2 | La implementación interpreta los parámetros de entidad SNMP como direcciones de transporte SNMP y parámetros de contexto como cadenas de comunidad SNMP literales. En el caso de las entidades de destino SNMPv2, la implementación crea mensajes SNMP salientes que contienen un valor de 1 en el campo de versión. |
La implementación intenta asociar recursos en su base de datos con la dirección de transporte literal de la entidad de administración.
Para cambiar la configuración del modo de traducción de entidad y contexto, una aplicación WinSNMP debe llamar a la función SnmpSetTranslateMode . Si el modo de traducción solicitado no es válido, se produce un error en la función y SnmpGetLastError devuelve el código de error SNMPAPI_MODE_INVALID.