SnmpExtensionInit 함수(snmp.h)

아티클
08/26/2023

[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]

Microsoft SNMP 서비스는 SnmpExtensionInit 함수를 호출하여 SNMP 확장 에이전트 DLL을 초기화합니다. 이 함수는 SNMP 확장 에이전트 API의 요소입니다.

구문

BOOL SNMP_FUNC_TYPE SnmpExtensionInit(
  [in]  DWORD               dwUptimeReference,
  [out] HANDLE              *phSubagentTrapEvent,
  [out] AsnObjectIdentifier *pFirstSupportedRegion
);

매개 변수

[in] dwUptimeReference

확장 에이전트에 대한 시간 0 참조를 지정합니다.

참고 확장 에이전트는 이 매개 변수를 무시해야 합니다. SNMP 확장 에이전트 DLL은 SnmpSvcGetUptime 함수를 사용하여 SNMP 서비스가 실행 중인 센티미터 수를 검색해야 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[out] phSubagentTrapEvent

확장 에이전트가 SNMP 서비스로 다시 전달되는 이벤트 핸들에 대한 포인터입니다. 이 핸들은 확장 에이전트에 보낼 하나 이상의 트랩이 있음을 서비스에 알리는 데 사용됩니다. 이벤트 핸들 할당 및 할당 취소에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

[out] pFirstSupportedRegion

확장 에이전트가 지원하는 첫 번째 MIB 하위 트리를 수신하기 위한 AsnObjectIdentifier 구조체에 대한 포인터입니다. 이 구조에 대한 리소스 할당 및 할당 취소에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

확장 에이전트는 SnmpExtensionInitEx 진입점 함수를 구현하여 추가 MIB 하위 트리를 등록할 수 있습니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다.

설명

확장 에이전트는 dwUptimeReference 매개 변수를 무시해야 합니다. 대신 SnmpSvcGetUptime 함수를 호출하여 Microsoft SNMP 서비스가 실행 중인 센티미터 수를 검색해야 합니다. dwUptimeReference 매개 변수는 경과된 시간을 DWORD 값으로 밀리초 단위로 저장하므로 시간은 0으로 래핑되고 부정확한 시간 간격을 반영할 수 있습니다.

확장 에이전트는 phSubagentTrapEvent 매개 변수에 다시 전달된 이벤트 핸들을 신호 상태로 설정하여 하나 이상의 트랩을 보내야 한다고 SNMP 서비스에 알릴 수 있습니다. 이 이벤트가 신호를 받은 후 SNMP 서비스는 함수가 FALSE 값을 반환할 때까지 확장 에이전트의 SnmpExtensionTrap 진입점을 반복적으로 호출 합니다. 이는 확장 에이전트에 보낼 트랩이 더 이상 없음을 나타냅니다. 확장 에이전트가 트랩을 생성하지 않으면 phSubagentTrapEvent 매개 변수는 NULL 값을 반환해야 합니다.

SNMP 확장 에이전트는 트랩 이벤트 핸들에 대한 리소스를 할당하고 할당 취소해야 합니다. SNMP 서비스가 SnmpExtensionInit 함수를 호출하는 경우 확장 에이전트는 CreateEvent 함수를 호출하여 이벤트 핸들을 할당해야 합니다. 확장 에이전트는 phSubagentTrapEvent 매개 변수의 SNMP 서비스에 핸들을 전달합니다. SNMP 서비스가 SnmpExtensionClose 함수를 호출하는 경우 확장 에이전트는 트랩 이벤트 핸들에 대한 리소스의 할당을 취소해야 합니다.

SNMP 서비스는 확장 에이전트가 pFirstSupportedRegion 매개 변수에서 반환하는 AsnObjectIdentifier 구조체의 복사본을 만듭니다. 확장 에이전트는 원래 구조와 연결된 리소스를 할당하고 할당 취소해야 합니다. SNMP 서비스가 SnmpExtensionClose 함수를 호출할 때 이 작업을 수행할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	snmp.h