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


Функция SnmpSetTimeout (winsnmp.h)

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

Функция SnmpSetTimeout WinSNMP позволяет приложению WinSNMP изменять значение времени ожидания для передачи запросов сообщений SNMP. Значение времени ожидания применяется к вызовам, которые приложение WinSNMP выполняет к функции SnmpSendMsg для указанного объекта управления. Реализация Microsoft WinSNMP сохраняет значение в базе данных.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTimeout(
  [in] HSNMP_ENTITY hEntity,
  [in] smiTIMETICKS nPolicyTimeout
);

Параметры

[in] hEntity

Обработка целевого объекта управления, который представляет интерес.

[in] nPolicyTimeout

Задает новое значение времени ожидания (в сотых секундах) для объекта управления. Это значение заменяет значение, хранящееся в базе данных реализации.

Если этот параметр равен нулю, а текущий режим повторной передачи равен SNMPAPI_ON, реализация выбирает значение времени ожидания. Реализация использует это значение времени ожидания при выполнении политики повторной передачи приложения WinSNMP.

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

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

Если функция завершается сбоем, возвращаемое значение SNMPAPI_FAILURE. Чтобы получить расширенные сведения об ошибке, вызовите SnmpGetLastError , указав значение NULL в параметре сеанса . Функция SnmpGetLastError может возвращать одну из следующих ошибок.

Код возврата Описание
SNMPAPI_NOT_INITIALIZED
Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR
Ошибка при выделении памяти.
SNMPAPI_ENTITY_INVALID
Недопустимый параметр hEntity .
SNMPAPI_OTHER_ERROR
Произошла неизвестная или неопределенная ошибка.

Комментарии

Обычно приложение диспетчера WinSNMP, а не приложение агента, вызывает функцию SnmpSetTimeout .

Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.

Требования

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

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

SnmpGetRetransmitMode

SnmpGetTimeout

SnmpSetRetransmitMode

Функции WinSNMP

Общие сведения об API WinSNMP