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


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

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

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

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

Параметры

[out] nRetransmitMode

Указатель на долгочисленную переменную без знака для получения текущего режима повторной передачи, действующего для реализации. Этот параметр может принимать одно из указанных ниже значений.

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

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

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

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

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

Комментарии

Обычно приложение WinSNMP, а не приложение агента, вызывает функцию SnmpGetRetransmitMode . Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.

Требования

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

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

SnmpSetRetransmitMode

SnmpStartup

Функции WinSNMP

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