Функция SnmpSetRetry (winsnmp.h)
[SNMP доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте удаленное управление Windows, которое является реализацией WS-Man майкрософт.]
Функция SnmpSetRetry WinSNMP позволяет приложению WinSNMP изменять значение счетчика повторных попыток для повторной передачи запросов сообщений SNMP. Число повторных попыток применяется к вызовам, которые приложение WinSNMP выполняет к функции SnmpSendMsg для указанной сущности управления. Реализация Microsoft WinSNMP сохраняет значение в базе данных.
Синтаксис
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetry(
[in] HSNMP_ENTITY hEntity,
[in] smiUINT32 nPolicyRetry
);
Параметры
[in] hEntity
Дескриптор целевой сущности управления.
[in] nPolicyRetry
Задает новое значение для счетчика повторных попыток для объекта управления. Это значение заменяет значение, хранящееся в базе данных реализации.
Если этот параметр равен нулю, а текущий режим повторной передачи равен SNMPAPI_ON, реализация выбирает значение для счетчика повторных попыток. Реализация использует это значение при выполнении политики повторной передачи приложения WinSNMP.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет SNMPAPI_SUCCESS.
Если функция завершается сбоем, возвращаемое значение будет SNMPAPI_FAILURE. Чтобы получить расширенные сведения об ошибке, вызовите SnmpGetLastError , указав значение NULL в параметре сеанса . Функция SnmpGetLastError может возвращать одну из следующих ошибок.
| Код возврата | Описание |
|---|---|
|
Функция SnmpStartup не была успешно завершена. |
|
Произошла ошибка при выделении памяти. |
|
Недопустимый параметр hEntity . |
|
Произошла неизвестная или неопределенная ошибка. |
Комментарии
Обычно приложение диспетчера WinSNMP, а не приложение агента, вызывает функцию SnmpSetRetry .
Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winsnmp.h |
| Библиотека | Wsnmp32.lib |
| DLL | Wsnmp32.dll |