Função SnmpSetTranslateMode (winsnmp.h)

Artigo
08/27/2023

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

A função WinSNMP SnmpSetTranslateMode permite que um aplicativo WinSNMP altere a entidade e o modo de tradução de contexto. A entidade e o modo de tradução de contexto afetam a interpretação e o retorno dos parâmetros de cadeia de caracteres de entrada e saída do WinSNMP.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

Parâmetros

[in] nTranslateMode

Especifica um valor para a nova entidade e o modo de tradução de contexto. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
SNMPAPI_TRANSLATED	A implementação do Microsoft WinSNMP 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 e parâmetros de contexto como cadeias de caracteres da comunidade SNMP. Para entidades de destino SNMPv2, a implementação cria mensagens SNMP de saída que contêm um valor 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 da comunidade SNMP. 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.

Retornar valor

Se a função for bem-sucedida, o valor retornado será SNMPAPI_SUCCESS.

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno	Descrição
SNMPAPI_NOT_INITIALIZED	A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR	Ocorreu um erro durante a alocação de memória.
SNMPAPI_MODE_INVALID	A implementação não dá suporte ao modo de tradução solicitado.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

A nova entidade e o modo de tradução de contexto afetam as chamadas subsequentes para as funções SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr e SnmpEntityToStr . O aplicativo WinSNMP pode alterar a entidade e o modo de tradução de contexto novamente fazendo outra chamada para SnmpSetTranslateMode com um valor nTranslateMode diferente.

Para obter informações adicionais, consulte Configurando o modo de tradução de entidade e contexto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winsnmp.h
Biblioteca	Wsnmp32.lib
DLL	Wsnmp32.dll