Поделиться через

Установка режима преобразования сущностей и контекста

  • Статья

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

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

Реализация возвращает текущую сущность по умолчанию и режим преобразования контекста в параметре nTranslateMode функции SnmpStartup . Чтобы получить текущую сущность и режим преобразования контекста, действующий для реализации, приложение может в любой момент вызвать функцию SnmpGetTranslateMode .

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

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

 

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

Чтобы изменить параметры режима преобразования сущностей и контекста, приложение WinSNMP должно вызвать функцию SnmpSetTranslateMode . Если запрошенный режим преобразования недопустим, функция завершается сбоем, а SnmpGetLastError возвращает код ошибки SNMPAPI_MODE_INVALID.