Функция SnmpSetTranslateMode (winsnmp.h)

Статья
03/04/2024

[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]

Функция WinSNMP SnmpSetTranslateMode позволяет приложению WinSNMP изменять режим преобразования сущностей и контекста. Режим преобразования сущности и контекста влияет на интерпретацию и возврат входных и выходных параметров строки WinSNMP.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

Параметры

[in] nTranslateMode

Задает значение для новой сущности и режима преобразования контекста. Этот параметр должен иметь одно из следующих значений.

Значение	Значение
SNMPAPI_TRANSLATED	Реализация Microsoft WinSNMP использует свою базу данных для преобразования понятных имен для сущностей SNMP и управляемых объектов. Реализация преобразует их в компоненты SNMPv1 или SNMPv2C.
SNMPAPI_UNTRANSLATED_V1	Реализация интерпретирует параметры сущности SNMP как транспортные адреса SNMP, а параметры контекста — как строки сообщества SNMP. Для конечных сущностей SNMPv2 реализация создает исходящие SNMP-сообщения, которые содержат нулевое значение в поле версии.
SNMPAPI_UNTRANSLATED_V2	Реализация интерпретирует параметры сущности SNMP как транспортные адреса SNMP, а параметры контекста — как строки сообщества SNMP. Для конечных сущностей SNMPv2 реализация создает исходящие SNMP-сообщения, содержащие значение 1 в поле версии.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет SNMPAPI_SUCCESS.

Если функция завершается сбоем, возвращаемое значение SNMPAPI_FAILURE. Чтобы получить расширенные сведения об ошибке, вызовите SnmpGetLastError , указав значение NULL в параметре сеанса . Функция SnmpGetLastError может возвращать одну из следующих ошибок.

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR	Ошибка при выделении памяти.
SNMPAPI_MODE_INVALID	Реализация не поддерживает запрошенный режим преобразования.
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Новый режим преобразования сущности и контекста влияет на последующие вызовы функций SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr и SnmpEntityToStr . Приложение WinSNMP может снова изменить режим преобразования сущности и контекста, выполнив еще один вызов SnmpSetTranslateMode с другим значением nTranslateMode .

Дополнительные сведения см. в разделе Настройка режима преобразования сущностей и контекста.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winsnmp.h
Библиотека	Wsnmp32.lib
DLL	Wsnmp32.dll