Функция 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 может возвращать одну из следующих ошибок.
| Код возврата | Описание |
|---|---|
|
Не удалось выполнить функцию SnmpStartup . |
|
Ошибка при выделении памяти. |
|
Недопустимый параметр hEntity . |
|
Параметры nPolicyRetry и nActualRetry имеют значение NULL. Операция не была выполнена. |
|
Произошла неизвестная или неопределенная ошибка. |
Комментарии
Обычно приложение WinSNMP, а не приложение агента, вызывает функцию SnmpGetTimeout .
Период ожидания — это интервал между вызовом приложения функции SnmpSendMsg и его вызовом функции SnmpRecvMsg .
Приложение WinSNMP может изменить значение времени ожидания с помощью вызова функции SnmpSetTimeout .
Приложение WinSNMP может отслеживать значение параметра nActualRetry и сравнивать его со значением параметра nPolicyRetry для оптимизации производительности передачи. Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winsnmp.h |
| Библиотека | Wsnmp32.lib |
| DLL | Wsnmp32.dll |