SnmpMgrTrapListen 함수(mgmtapi.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
SnmpMgrTrapListen 함수는 SNMP 트랩 서비스에서 SNMP 트랩을 수신하는 SNMP 관리자 애플리케이션의 기능을 등록합니다. 이 함수는 SNMP 관리 API의 요소입니다.
구문
BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
[out] HANDLE *phTrapAvailable
);
매개 변수
[out] phTrapAvailable
사용할 수 있는 트랩이 있고 애플리케이션이 SnmpMgrGetTrap 함수를 호출해야 한다는 표시를 수신하기 위한 이벤트 핸들에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장된 오류 정보를 얻으려면 GetLastError를 호출합니다. 이 오류 코드는 다음 오류 코드를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
메모리 할당 오류를 나타냅니다. |
|
이 함수가 이미 호출되었음을 나타냅니다. |
|
하나 이상의 오류가 발생했음을 나타냅니다. 트랩에 액세스할 수 없습니다. 애플리케이션은 함수를 다시 호출하려고 시도할 수 있습니다. |
이 함수는 다른 시스템 오류도 반환할 수 있습니다.
설명
관리자가 아닌 사용자의 경우 SNMP 트랩 서비스가 시작된 경우에만 SnmpMgrTrapListen 함수가 성공합니다.
애플리케이션은 SnmpMgrGetTrap 함수를 호출하기 전에 항상 SnmpMgrTrapListen 함수를 호출해야 합니다. phTrapAvailable 매개 변수가 가리키는 이벤트 핸들을 통해 SNMP 트랩을 이벤트 구동으로 획득할 수 있기 때문입니다. SNMP 관리 API는 SNMP 트랩 서비스가 트랩을 제공할 때 애플리케이션의 이벤트를 신호로 보냅니다.
애플리케이션은 정기적으로 트랩에 대해 SnmpMgrGetTrap 함수를 폴링할 수도 있습니다. 이 경우 애플리케이션은 함수가 0을 반환할 때까지 SnmpMgrGetTrap 을 반복적으로 호출해야 합니다.
Windows Server 2003: SNMP 관리자 애플리케이션은 NULL세션 매개 변수를 사용하여 SnmpMgrClose를 호출하여 SnmpMgrTrapListen 함수에 대한 성공적인 호출과 관련된 리소스를 클린 수 있습니다. 그러나 애플리케이션이 DLL인 경우 DllMain 진입점 함수에서 SnmpMgrClose를 호출해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgmtapi.h |
| 라이브러리 | Mgmtapi.lib |
| DLL | Mgmtapi.dll |