функция обратного вызова SNMPAPI_CALLBACK (winsnmp.h)

Статья
08/27/2023

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

Реализация Microsoft WinSNMP вызывает функцию SNMPAPI_CALLBACK для уведомления сеанса WinSNMP о доступности сообщения SNMP или асинхронного события.

SNMPAPI_CALLBACK — это заполнитель для имени определяемой приложением или библиотекой функции обратного вызова.

Синтаксис

SNMPAPI_CALLBACK SnmpapiCallback;

SNMPAPI_STATUS SnmpapiCallback(
  [in] HSNMP_SESSION hSession,
  [in] HWND hWnd,
  [in] UINT wMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
  [in] LPVOID lpClientData
)
{...}

Параметры

[in] hSession

Дескриптор сеанса WinSNMP.

[in] hWnd

Обработка в окно приложения WinSNMP для уведомления о завершении асинхронного запроса или получении уведомления о ловушке. Этот параметр не имеет значения для сеанса WinSNMP, но реализация всегда передает значение функции обратного вызова.

[in] wMsg

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

[in] wParam

Задает определяемое приложением 32-разрядное значение, определяющее тип уведомления. Если этот параметр равен нулю, для сеанса доступно сообщение SNMP. Приложение должно вызвать функцию SnmpRecvMsg для получения сообщения. Если этот параметр не равен нулю, он указывает на асинхронное уведомление о событии для сеанса. Дополнительные сведения см. в следующем разделе Примечаний.

[in] lParam

Задает определяемое приложением 32-разрядное значение, указывающее идентификатор запроса обрабатываемого PDU.

[in] lpClientData

Если параметр lpClientData не был равен NULL при вызове функции SnmpCreateSession для этого сеанса, этот параметр является указателем на данные, определяемые приложением.

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

Функция должна возвращать SNMPAPI_SUCCESS, чтобы продолжить выполнение приложения. Если функция возвращает любое другое значение, реализация отвечает так, как если бы приложение вызывало функцию SnmpClose для указанного сеанса.

Когда реализация выполняет политику повторной передачи для приложения WinSNMP и возникает время ожидания передачи, реализация сообщает сеансу об ошибке. В этом случае значение параметра wParam будет SNMPAPI_TL_TIMEOUT. Список других ошибок транспортного уровня см. на страницах ссылок по функциям SnmpRegister, SnmpSendMsg и SnmpRecvMsg .

Требования

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

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

SnmpClose

SnmpCreateSession

Функции WinSNMP

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