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


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

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

Функция SnmpGetRetry WinSNMP возвращает значение счетчика повторных попыток в единицах для повторной передачи запросов сообщений SNMP. Количество повторных попыток применяется к вызовам, которые приложение WinSNMP выполняет к функции SnmpSendMsg для указанной сущности управления.

Синтаксис

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetry(
  [in]  HSNMP_ENTITY hEntity,
  [out] smiLPUINT32  nPolicyRetry,
  [out] smiLPUINT32  nActualRetry
);

Параметры

[in] hEntity

Обработка целевого объекта управления, который представляет интерес.

[out] nPolicyRetry

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

[out] nActualRetry

Указатель на длинную целочисленную переменную без знака, чтобы получить последнее фактическое или предполагаемое число повторных попыток для конечной сущности, как сообщает реализация. Если сведения, возвращаемые в этом параметре, не требуются, nActualRetry должен быть указателем NULL . Если этот параметр является допустимым указателем, функция возвращает значение 0. Дополнительные сведения см. в следующем разделе Примечаний.

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

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

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

Код возврата Описание
SNMPAPI_NOT_INITIALIZED
Не удалось выполнить функцию SnmpStartup .
SNMPAPI_ALLOC_ERROR
Ошибка при выделении памяти.
SNMPAPI_ENTITY_INVALID
Недопустимый параметр hEntity .
SNMPAPI_NOOP
Параметры nPolicyRetry и nActualRetry имеют значение NULL. Операция не была выполнена.
SNMPAPI_OTHER_ERROR
Произошла неизвестная или неопределенная ошибка.

Комментарии

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

Приложение WinSNMP может изменить значение счетчика повторных попыток с помощью вызова функции SnmpSetRetry .

Приложение WinSNMP может отслеживать значение параметра nActualRetry и сравнивать его со значением параметра nPolicyRetry для оптимизации производительности передачи. Дополнительные сведения см. в разделах Сведения о повторной отправке и Управление политикой повторной передачи.

Требования

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

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

SnmpGetRetransmitMode

SnmpSetRetransmitMode

SnmpSetRetry

Функции WinSNMP

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