Share via

Функции SNMP

  • Статья

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

В этом разделе описываются три группы функций SNMP и перечислены функции, входящие в каждую группу:

Функции API агента расширения SNMP

Функции агента расширения SNMP определяют интерфейс между службой SNMP и сторонними библиотеками DLL агента расширения SNMP. В следующей таблице перечислены функции, которые приложения могут использовать для разрешения привязок переменных, заданных входящими единицами данных протокола SNMP.

Функция API агента расширения SNMP Описание
SnmpExtensionClose Запрашивает, чтобы агент расширения SNMP отменял выделение ресурсов и завершал операции.
SnmpExtensionInit Инициализирует библиотеку DLL агента расширения SNMP.
SnmpExtensionInitEx Определяет все дополнительные поддеревья базы сведений об управлении (MIB), поддерживаемые агентом расширения SNMP.
SnmpExtensionMonitor Предоставляет агенту расширения SNMP сведения о внутренних счетчиках и параметрах службы.
SnmpExtensionQuery Разрешает запросы SNMP, содержащие переменные в одном или нескольких зарегистрированных поддеревьяХ MIB агента расширения SNMP.
SnmpExtensionQueryEx Обрабатывает запросы SNMP, указывающие переменные в одном или нескольких поддеревьях MIB, зарегистрированных агентами расширения SNMP.
SnmpExtensionTrap Извлекает сведения, необходимые службе для создания ловушек для агента расширения SNMP.

 

Функции API управления SNMP

Функции управления SNMP определяют интерфейс между сторонними приложениями диспетчера SNMP и библиотекой динамической компоновки функций управления (DLL) Mgmtapi.dll. Библиотека DLL работает в сочетании со службой snmp trap (Snmptrap.exe) и может взаимодействовать с одним или несколькими сторонними приложениями диспетчера SNMP. В следующей таблице перечислены функции управления, которые сторонние приложения диспетчера используют для выполнения операций диспетчера SNMP.

Функция API управления SNMP Описание
SnmpMgrClose Закрывает сокеты связи и структуры данных, связанные с указанным сеансом.
SnmpMgrCtl Задает операционный параметр, связанный с сеансом SNMP.
SnmpMgrGetTrap Возвращает незавершенные данные ловушки, которые вызывающий объект не получил, если включен прием ловушки.
SnmpMgrGetTrapEx Возвращает незавершенные данные ловушки, которые вызывающий объект не получил, если включен прием ловушки. Также возвращает адрес источника транспорта и ловушку сообщества, связанную с ловушкой.
SnmpMgrOidToStr Преобразует структуру идентификатора внутреннего объекта в строковое представление.
SnmpMgrOpen Инициализирует сокеты связи и структуры данных, необходимые для установления связи с агентом SNMP.
SnmpMgrRequest Запрашивает выполнение указанной операции указанным агентом.
SnmpMgrStrToOid Преобразует строковый формат идентификатора объекта во внутреннюю структуру идентификатора объекта.
SnmpMgrTrapListen Регистрирует возможность приложения диспетчера SNMP получать snmp-ловушки из службы snmp trap.

 

Функции API служебной программы SNMP

Служебные функции SNMP предоставляют возможности, полезные при разработке приложений SNMP, включая упрощение обработки структур данных SNMP. В следующей таблице перечислены служебные функции SNMP.

Функция API служебной программы SNMP Описание
SnmpSvcGetUptime Извлекает время (в центисекундах), в течение которого была запущена служба SNMP.
SnmpSvcSetLogLevel Настраивает уровень детализации выходных данных отладки из службы SNMP и агентов расширения SNMP.
SnmpSvcSetLogType Настраивает назначение для выходных данных отладки из службы SNMP и агентов расширения SNMP.
SnmpUtilAsnAnyCpy Копирует исходную структуру AsnAny в целевую структуру AsnAny .
SnmpUtilAsnAnyFree Освобождает память, выделенную для указанной структуры AsnAny .
SnmpUtilDbgPrint Задает уровень сведений об отладке, получаемых от службы SNMP или из вызова SnmpUtilDbgPrint.
SnmpUtilIdsToA Преобразует идентификатор объекта (OID) в строку, завершаемую null.
SnmpUtilMemAlloc Выделяет динамическую память из кучи процесса.
SnmpUtilMemFree Освобождает указанный объект памяти.
SnmpUtilMemReAlloc Изменяет размер указанного объекта памяти.
SnmpUtilOctetsCmp Сравнивает две строки октета.
SnmpUtilOctetsCpy Копирует исходную структуру AsnOctetString в целевую структуру AsnOctetString .
SnmpUtilOctetsFree Освобождает память, выделенную для указанной строки октета.
SnmpUtilOctetsNCmp Выполняет сравнение двух строк октета с указанным числом подидентификаторов.
SnmpUtilOidAppend Добавляет идентификатор исходного объекта, содержащийся в структуре AsnObjectIdentifier , к идентификатору целевого объекта.
SnmpUtilOidCmp Сравнивает два идентификатора объектов, содержащихся в структурах AsnObjectIdentifier .
SnmpUtilOidCpy Копирует исходную структуру AsnObjectIdentifier в целевую структуру AsnObjectIdentifier .
SnmpUtilOidFree Освобождает память, выделенную для указанного идентификатора объекта.
SnmpUtilOidNCmp Сравнивает два идентификатора объектов, содержащихся в структурах AsnObjectIdentifier , с указанным числом подидентификаторов.
SnmpUtilOidToA Преобразует идентификатор объекта (OID) в строку, завершаемую null.
SnmpUtilPrintAsnAny Выводит значение, содержащееся в структуре AsnAny , для целей отладки и разработки.
SnmpUtilPrintOid Форматирует указанный идентификатор объекта (OID) и выводит результат на стандартное устройство вывода.
SnmpUtilVarBindCpy Копирует исходную структуру SnmpVarBind в целевую структуру SnmpVarBind .
SnmpUtilVarBindListCpy Копирует исходную структуру SnmpVarBindList в целевую структуру SnmpVarBindList .
SnmpUtilVarBindFree Освобождает память, выделенную для указанной структуры SnmpVarBind .
SnmpUtilVarBindListFree Освобождает память, выделенную для указанной структуры SnmpVarBindList .