Функция SnmpMgrClose (mgmtapi.h)
[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]
Функция SnmpMgrClose закрывает сокеты связи и структуры данных, связанные с указанным сеансом. Эта функция является элементом API управления SNMP.
Синтаксис
BOOL SNMP_FUNC_TYPE SnmpMgrClose(
[in] LPSNMP_MGR_SESSION session
);
Параметры
[in] session
Указатель на внутреннюю структуру, указывающую сеанс для закрытия. Дополнительные сведения см. в разделе "Примечания".
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Эта функция может возвращать коды ошибок сокетов Windows.
Комментарии
Windows Server 2003: Приложения диспетчера SNMP могут вызывать SnmpMgrClose с параметром сеансаNULL для очистки ресурсов, связанных с успешным вызовом функции SnmpMgrTrapListen. Однако обратите внимание, что если приложение является библиотекой DLL, оно не должно вызывать SnmpMgrClose из своей функции точки входа DllMain .
SnmpMgrClose не следует вызывать, когда библиотека DLL приложения находится в процессе выгрузки.
Windows Server 2003: выполнение SnmpMgrClose в Windows Server 2003 занимает больше времени по сравнению с идентичным вызовом в Windows 2000. В частности, вызов этого API занимает до секунды для выполнения в Windows Server 2003, в то время как тот же вызов занимает около 0,3 миллисекунд в Windows 2000. Это может привести к проблемам с производительностью для приложений SNMP Windows Server 2003, которые часто вызывают SnmpMgrOpen и SnmpMgrClose .
Чтобы устранить эту проблему, создайте дополнительный сеанс диспетчера SNMP, вызвав SnmpMgrOpen на локальном узле во время запуска приложения и сохраняйте его открытым на протяжении всего времени существования приложения. Закрытие диспетчера сеансов приведет к закрытию всех связанных сеансов, требуя только одного вызова SnmpMgrClose.
Windows Server 2003 с пакетом обновления 1 (SP1): Указанная выше проблема не относится к Windows 2003 с пакетом обновления 1 (SP1).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mgmtapi.h |
| Библиотека | Mgmtapi.lib |
| DLL | Mgmtapi.dll |