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

Статья
08/27/2023

[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	Произошла неизвестная или неопределенная ошибка.

Требования

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

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

SnmpGetRetransmitMode

SnmpGetRetry

SnmpSetRetransmitMode

Функции WinSNMP

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