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