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


Функция 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 может возвращать одну из следующих ошибок.

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

Комментарии

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

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

Требования

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

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

SnmpGetRetransmitMode

SnmpGetRetry

SnmpSetRetransmitMode

Функции WinSNMP

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