SnmpExtensionMonitor 함수(snmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
Microsoft SNMP 서비스는 SnmpExtensionMonitor 함수를 호출하여 SNMP 확장 에이전트에 서비스의 내부 카운터 및 매개 변수에 대한 보기를 제공합니다. 이 함수는 SNMP 확장 에이전트 API의 요소입니다.
SnmpExtensionMonitor 함수는 선택 사항입니다. 확장 에이전트는 RFC 1213, "TCP/IP 기반 인터넷의 네트워크 관리를 위한 관리 정보 기반: MIB-II"에 정의된 대로 SNMP 서비스의 내부 관리 개체 보기에 관심이 있는 경우 함수를 구현해야 합니다.
구문
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
매개 변수
[in] pAgentMgmtData
AsnAny 개체(구조체)의 배열에 대한 포인터입니다. 개체 수와 각 개체의 형식 및 설명은 RFC 1213에 따라 다릅니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
반환 값
SNMP 확장 에이전트가 pAgentMgmtData 매개 변수 값을 처리하는 동안 예기치 않은 오류가 발생하지 않는 한 확장 에이전트는 TRUE를 반환해야 합니다. 확장 에이전트가 FALSE를 반환하는 경우 SNMP 서비스는 확장 에이전트를 로드하지 않고 서비스에서 SNMP 요청을 확장 에이전트로 전송하는 것을 중지합니다.
설명
확장 에이전트가 SnmpExtensionMonitor 함수를 내보내는 경우 SNMP 서비스는 SnmpExtensionInit 및 SnmpExtensionInitEx 함수를 호출한 직후 확장 에이전트를 초기화하는 동안 함수를 호출합니다.
SNMP 서비스는 pAgentMgmtData 매개 변수가 가리키는 배열에서 SNMP 카운터(예: snmpInPkts 및 snmpOutNoSuchNames 카운터)를 동적으로 업데이트합니다. SNMP 서비스가 실행되는 동안 이러한 값을 읽을 수 있도록 확장 에이전트는 pAgentMgmtData에 대한 포인터를 저장해야 합니다.
SNMP 확장 에이전트는 pAgentMgmtData 매개 변수가 가리키는 메모리를 업데이트해서는 안 됩니다. 이는 SNMP 서비스의 내부 카운터 값이 더 이상 유효하지 않고 SNMP 서비스의 동작을 예측할 수 없기 때문입니다. 확장 에이전트가 변경하지 않는 한 SNMP 서비스가 실행되는 동안 pAgentMgmtData 가 가리키는 메모리가 유효합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | snmp.h |