Функция SnmpMgrOpen (mgmtapi.h)
[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 |