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

Статья
08/27/2023

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

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

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTranslateMode(
  [out] smiLPUINT32 nTranslateMode
);

Параметры

[out] nTranslateMode

Указатель на переменную с длинным целым числом без знака для получения режима преобразования сущности и контекста, который действует для реализации Microsoft WinSNMP. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
SNMPAPI_TRANSLATED	Реализация использует свою базу данных для преобразования понятных имен для сущностей SNMP и управляемых объектов. Реализация преобразует их в компоненты SNMPv1 или SNMPv2C.
SNMPAPI_UNTRANSLATED_V1	Реализация интерпретирует параметры сущности SNMP как транспортные адреса SNMP, а параметры контекста — как строки сообщества SNMP. Для целевых сущностей SNMPv2 реализация создает исходящие СООБЩЕНИЯ SNMP, содержащие нулевое значение в поле версии.
SNMPAPI_UNTRANSLATED_V2	Реализация интерпретирует параметры сущности SNMP как транспортные адреса SNMP, а параметры контекста — как строки сообщества SNMP. Для конечных сущностей SNMPv2 реализация создает исходящие СООБЩЕНИЯ SNMP, содержащие значение 1 в поле версии.

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

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

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

Код возврата	Описание
SNMPAPI_NOT_INITIALIZED	Функция SnmpStartup не была успешно завершена.
SNMPAPI_ALLOC_ERROR	Произошла ошибка при выделении памяти.
SNMPAPI_OTHER_ERROR	Произошла неизвестная или неопределенная ошибка.

Режим преобразования сущностей и контекста влияет на вызовы функций SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr и SnmpEntityToStr . Дополнительные сведения см. в разделе Настройка режима преобразования сущностей и контекста.

Требования

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