Compartilhar via

Definindo o modo de conversão de entidade e contexto

  • Artigo

O aplicativo WinSNMP pode especificar a interpretação e a tradução de parâmetros de entidade e contexto definindo a entidade e o modo de tradução de contexto. A implementação do Microsoft WinSNMP armazena o modo em um banco de dados.

A configuração da entidade e do modo de tradução de contexto determina a maneira como a função SnmpStrToEntity e a função SnmpStrToContext interpretam cadeias de caracteres de entrada. A configuração também determina o tipo de cadeia de caracteres de saída que as funções SnmpEntityToStr e SnmpContextToStr retornam. Para obter mais informações, consulte Suporte para cadeias de caracteres de endereço IPX no WinSNMP.

A implementação retorna a entidade padrão atual e o modo de tradução de contexto no parâmetro nTranslateMode da função SnmpStartup . Para recuperar a entidade atual e o modo de tradução de contexto em vigor para a implementação, um aplicativo pode chamar a função SnmpGetTranslateMode a qualquer momento.

Os modos válidos de conversão de entidade e contexto seguem.

Mode Significado
SNMPAPI_TRANSLATED A implementação usa seu banco de dados para traduzir nomes amigáveis para entidades SNMP e objetos gerenciados. A implementação os converte em seus componentes SNMPv1 ou SNMPv2C.
SNMPAPI_UNTRANSLATED_V1 A implementação interpreta parâmetros de entidade SNMP como endereços de transporte SNMP literais e parâmetros de contexto como cadeias de caracteres de comunidade SNMP literais. Para entidades de destino SNMPv2, a implementação cria mensagens SNMP de saída que contêm um valor igual a zero no campo de versão.
SNMPAPI_UNTRANSLATED_V2 A implementação interpreta parâmetros de entidade SNMP como endereços de transporte SNMP e parâmetros de contexto como cadeias de caracteres de comunidade SNMP literais. Para entidades de destino SNMPv2, a implementação cria mensagens SNMP de saída que contêm um valor de 1 no campo de versão.

 

A implementação tenta associar recursos em seu banco de dados ao endereço de transporte literal da entidade de gerenciamento.

Para alterar a configuração da entidade e do modo de tradução de contexto, um aplicativo WinSNMP deve chamar a função SnmpSetTranslateMode . Se o modo de tradução solicitado for inválido, a função falhará e SnmpGetLastError retornará o código de erro SNMPAPI_MODE_INVALID.