SNMPAPI_CALLBACK 콜백 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
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비트 값을 지정합니다. 이 매개 변수가 0과 같으면 세션에 SNMP 메시지를 사용할 수 있습니다. 애플리케이션은 메시지를 검색하기 위해 SnmpRecvMsg 함수를 호출해야 합니다. 이 매개 변수가 0이 아니면 세션에 대한 비동기 이벤트 알림을 나타냅니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
[in] lParam
처리 중인 PDU의 요청 식별자를 지정하는 애플리케이션 정의 32비트 값을 지정합니다.
[in] lpClientData
이 세션에 대한 SnmpCreateSession 함수 호출 시 lpClientData 매개 변수가 NULL이 아닌 경우 이 매개 변수는 애플리케이션 정의 데이터에 대한 포인터입니다.
반환 값
함수는 애플리케이션 실행을 계속하려면 SNMPAPI_SUCCESS 반환해야 합니다. 함수가 다른 값을 반환하면 애플리케이션이 표시된 세션에 대해 SnmpClose 함수를 호출한 것처럼 구현이 응답합니다.
설명
구현이 WinSNMP 애플리케이션에 대한 재전송 정책을 실행하고 전송 시간 초과가 발생하면 구현에서 오류를 세션에 알릴 수 있습니다. 이 경우 wParam 매개 변수의 값은 SNMPAPI_TL_TIMEOUT. 다른 전송 계층 오류 목록은 SnmpRegister, SnmpSendMsg 및 SnmpRecvMsg 함수에 대한 참조 페이지를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | winsnmp.h |