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

Функции SNMP

  • Статья

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

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

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

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

Функция 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 (Snmptrap.exe) и может взаимодействовать с одним или несколькими сторонними приложениями диспетчера SNMP. В следующей таблице перечислены функции управления, используемые сторонними приложениями диспетчера для выполнения операций диспетчера SNMP.

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

 

Функции 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.