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

Статья
08/26/2023

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

Служба MICROSOFT SNMP вызывает функцию SnmpExtensionInit для инициализации библиотеки DLL агента расширения SNMP. Эта функция является элементом API агента расширения SNMP.

Синтаксис

BOOL SNMP_FUNC_TYPE SnmpExtensionInit(
  [in]  DWORD               dwUptimeReference,
  [out] HANDLE              *phSubagentTrapEvent,
  [out] AsnObjectIdentifier *pFirstSupportedRegion
);

Параметры

[in] dwUptimeReference

Указывает нулевую ссылку по времени для агента расширения.

Примечание Агенты расширения должны игнорировать этот параметр. Библиотека DLL агента расширения SNMP должна использовать функцию SnmpSvcGetUptime для получения количества сантиметров, запущенных службой SNMP. Дополнительные сведения см. в разделе "Примечания".

[out] phSubagentTrapEvent

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

[out] pFirstSupportedRegion

Указатель на структуру AsnObjectIdentifier , чтобы получить первое поддерево MIB, которое поддерживает агент расширения. Дополнительные сведения о выделении и освобождении ресурсов для этой структуры см. в следующем разделе Примечаний.

Агент расширения может регистрировать дополнительные поддереви MIB, реализовав функцию точки входа SnmpExtensionInitEx .

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

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE.

Агенты расширения должны игнорировать параметр dwUptimeReference . Вместо этого им следует вызвать функцию SnmpSvcGetUptime , чтобы получить количество сантиметров, запущенных службой MICROSOFT SNMP. Так как параметр dwUptimeReference сохраняет затраченное время в виде значения DWORD в миллисекундах, время может быть равно нулю и отражать неточный интервал времени.

Агент расширения уведомляет службу SNMP о необходимости отправить одну или несколько ловушек, задавая дескриптор события, переданный обратно в параметре phSubagentTrapEvent , в состояние сигнальной передачи. После передачи сигнала об этом событии служба SNMP неоднократно вызывает точку входа SnmpExtensionTrap агента расширения, пока функция не вернет значение FALSE. Это означает, что у агента расширения больше нет ловушек для отправки. Если агент расширения не создает ловушки, параметр phSubagentTrapEvent должен возвращать значение NULL.

Агент расширения SNMP должен выделить и освободить ресурсы для дескриптора событий ловушки. Когда служба SNMP вызывает функцию SnmpExtensionInit , агент расширения должен вызвать функцию CreateEvent , чтобы выделить дескриптор события. Агент расширения передает дескриптор службе SNMP в параметре phSubagentTrapEvent . Когда служба SNMP вызывает функцию SnmpExtensionClose , агент расширения должен освободить ресурсы для дескриптора события ловушки.

Служба SNMP создает копию структуры AsnObjectIdentifier , возвращаемой агентом расширения в параметре pFirstSupportedRegion . Агент расширения должен выделить и освободить ресурсы, связанные с исходной структурой. Это можно сделать, когда служба SNMP вызывает функцию SnmpExtensionClose .

Требования

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