Установка режима преобразования сущностей и контекста
Приложение 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.