Функция SnmpExtensionMonitor (snmp.h)

Статья
03/02/2024

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

Служба Microsoft SNMP вызывает функцию SnmpExtensionMonitor , чтобы предоставить агенту расширения SNMP сведения о внутренних счетчиках и параметрах службы. Эта функция является элементом API агента расширения SNMP.

Функция SnmpExtensionMonitor является необязательной. Агенты расширений должны реализовать функцию, если они заинтересованы в представлении внутренних объектов управления службы SNMP, как определено в RFC 1213 , "Management Information Base for Network Management of TCP/IP-based Internets: MIB-II".

Синтаксис

BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
  [in] LPVOID pAgentMgmtData
);

Параметры

[in] pAgentMgmtData

Указатель на массив объектов (структур ) AsnAny . Количество объектов, а также тип и описание каждого объекта соответствуют стандарту RFC 1213. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

Если не произошла непредвиденная ошибка, когда агент расширения SNMP обрабатывает значение параметра pAgentMgmtData , агент расширения должен вернуть значение TRUE. Если агент расширения возвращает значение FALSE, служба SNMP не загружает агент расширения и служба перестает направлять запросы SNMP к агенту расширения.

Если агент расширения экспортирует функцию SnmpExtensionMonitor , служба SNMP вызывает функцию во время инициализации агента расширения сразу после того, как служба вызывает функции SnmpExtensionInit и SnmpExtensionInitEx .

Служба SNMP динамически обновляет счетчики SNMP (например, счетчики snmpInPkts и snmpOutNoSuchNames) в массиве, на который указывает параметр pAgentMgmtData . Чтобы иметь возможность считывать эти значения во время работы службы SNMP, агент расширения должен сохранить указатель на pAgentMgmtData.

Обратите внимание, что агент расширения SNMP не должен обновлять память, на которую указывает параметр pAgentMgmtData . Это связано с тем, что значения внутренних счетчиков службы SNMP больше не будут допустимыми, а поведение службы SNMP может стать непредсказуемым. Пока агент расширения не изменяет его, память, на которую указывает pAgentMgmtData , действительна во время работы службы SNMP.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	snmp.h