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


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

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

Функция SnmpSetRetransmitMode WinSNMP позволяет приложению WinSNMP задать режим повторной передачи. Реализация Microsoft WinSNMP использует новый режим повторной передачи для управления временем ожидания передачи и повторных попыток передачи при последующих вызовах функции SnmpSendMsg .

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Параметры

[in] nRetransmitMode

Задает значение для нового режима повторной передачи. Этот параметр должен иметь одно из следующих значений.

Значение Значение
SNMPAPI_ON
Реализация выполняет политику повторной передачи приложения WinSNMP.
SNMPAPI_OFF
Реализация не выполняет политику повторной передачи приложения WinSNMP.

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

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

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

Код возврата Описание
SNMPAPI_NOT_INITIALIZED
Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR
Ошибка при выделении памяти.
SNMPAPI_MODE_INVALID
Реализация не поддерживает запрошенный режим повторной передачи.
SNMPAPI_OTHER_ERROR
Произошла неизвестная или неопределенная ошибка.

Комментарии

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

Если приложение WinSNMP задает режим повторной передачи SNMPAPI_OFF, реализация не инициирует попытки повторной передачи для новых операций связи SNMP. Новый параметр влияет на все последующие вызовы функции SnmpSendMsg , пока приложение WinSNMP не установит режим повторной передачи обратно в SNMPAPI_ON.

Вызов функции SnmpCancelMsg эквивалентен вызову функции SnmpSetRetransmitMode для определенного SNMP-сообщения с режимом повторной передачи, равным SNMPAPI_OFF.

Примечание Если реализация возвращает ошибку SNMPAPI_MODE_INVALID вызову SnmpSetRetransmitMode, приложение WinSNMP должно выполнить политику повторной передачи.
 
Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.

Требования

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

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

SnmpCancelMsg

SnmpGetRetransmitMode

SnmpGetRetry

SnmpGetTimeout

SnmpRegister

SnmpSendMsg

Функции WinSNMP

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