Функция SnmpMgrOpen (mgmtapi.h)

Статья
08/24/2023

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

Функция SnmpMgrOpen инициализирует сокеты связи и структуры данных, обеспечивая обмен данными с указанным агентом SNMP. Эта функция является элементом API управления SNMP.

Синтаксис

LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
  [in] LPSTR lpAgentAddress,
  [in] LPSTR lpAgentCommunity,
  [in] INT   nTimeOut,
  [in] INT   nRetries
);

Параметры

[in] lpAgentAddress

Указатель на строку, завершающуюся значением NULL, которая указывает имя узла или IP-адрес. Имя узла должно разрешаться в IP-адрес, IPX-адрес (в нотации 8.12) или в адрес Ethernet. Допустимые формы для имен узлов и IP-адресов см. в разделе Примечания.

[in] lpAgentCommunity

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

[in] nTimeOut

Указывает время ожидания связи в миллисекундах.

[in] nRetries

Указывает число повторных попыток связи. Время ожидания, указанное в параметре nTimeOut , удваивается при каждой передаче повторных попыток.

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

Если функция выполняется успешно, возвращаемое значение является указателем на структуру LPSNMP_MGR_SESSION . Эта структура используется для внутреннего использования, и программист не должен изменять ее. Дополнительные сведения см. в разделе "Примечания".

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. GetLastError может вернуть код ошибки SNMP_MEM_ALLOC_ERROR, который указывает на ошибку выделения памяти.

Эта функция также может возвращать коды ошибок сокетов Windows.

По возможности используйте имя узла для идентификации агента SNMP в параметре lpAgentAddress . Имена узлов можно предоставить для агентов, только если загружен протокол TCP/IP и имена узлов TCP/IP. NetBIOS-имена не могут быть предоставлены для узлов IPX.

Имя и адрес целевого объекта SNMP или строка, на которую указывает параметр lpAgentAddress , должны соответствовать одной из следующих форм.

Имя или адрес	Форма (пример)
Имя компьютера	мерлин или merlin.microsoft.com
Адрес IPv4	157.57.8.160
Адрес IPv6	3ffe:8311:ffff::b3ff:fe88:c33
MAC-адрес	00aa00bbccdd
IPX-адрес	00006112.00aa00bbccdd

Приложения не должны использовать указатель LPSNMP_MGR_SESSION , возвращаемый этой функцией, для вызова функции SnmpMgrRequest в контексте другого потока.

Требования

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

См. также раздел

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