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

  • Статья

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

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

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
  [in]  HSNMP_ENTITY   hEntity,
  [out] smiLPTIMETICKS nPolicyTimeout,
  [out] smiLPTIMETICKS nActualTimeout
);

Параметры

[in] hEntity

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

[out] nPolicyTimeout

Указатель на целочисленную переменную для получения значения времени ожидания (в сотых секундах) для указанной сущности управления. Это значение, которое реализация Microsoft WinSNMP хранит в базе данных. Если сведения, возвращаемые в этом параметре, не требуются, nPolicyRetry должен быть указателем NULL .

[out] nActualTimeout

Указатель на целочисленную переменную для получения последнего фактического или предполагаемого интервала ответа для целевой сущности, как сообщает реализация. Если сведения, возвращаемые в этом параметре, не требуются, nActualRetry должен быть указателем NULL . Если этот параметр является допустимым указателем, функция возвращает значение 0. Дополнительные сведения см. в следующем разделе Примечаний.

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

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

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

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

Комментарии

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

Период ожидания — это интервал между вызовом приложения функции SnmpSendMsg и его вызовом функции SnmpRecvMsg .

Приложение WinSNMP может изменить значение времени ожидания с помощью вызова функции SnmpSetTimeout .

Приложение WinSNMP может отслеживать значение параметра nActualRetry и сравнивать его со значением параметра nPolicyRetry для оптимизации производительности передачи. Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.

Требования

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

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

SnmpGetRetransmitMode

SnmpSetRetransmitMode

SnmpSetTimeout

Функции WinSNMP

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