SnmpMgrClose 함수(mgmtapi.h)

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

SnmpMgrClose 함수는 지정된 세션과 연결된 통신 소켓 및 데이터 구조를 닫습니다. 이 함수는 SNMP Management API의 요소입니다.

구문

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

매개 변수

[in] session

닫을 세션을 지정하는 내부 구조체에 대한 포인터입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

이 함수는 Windows 소켓 오류 코드를 반환할 수 있습니다.

설명

Windows Server 2003: SNMP 관리자 애플리케이션은 NULL세션 매개 변수를 사용하여 SnmpMgrClose를 호출하여 SnmpMgrTrapListen 함수에 대한 성공적인 호출과 연결된 리소스를 클린 수 있습니다. 그러나 애플리케이션이 DLL인 경우 DllMain 진입점 함수에서 SnmpMgrClose를 호출해서는 안 됩니다.

애플리케이션 DLL이 언로드 중일 때는 SnmpMgrClose를 호출해서는 안 됩니다.

Windows Server 2003: SnmpMgrClose 는 Windows 2000에서 동일한 호출과 비교할 때 Windows Server 2003에서 실행하는 데 더 오래 걸립니다. 특히 이 API에 대한 호출은 Windows Server 2003에서 실행하는 데 최대 1초가 걸리지만 동일한 호출은 Windows 2000에서 약 3밀리초 정도 걸립니다. 이로 인해 SnmpMgrOpen 및 SnmpMgrClose 를 자주 호출하는 Windows Server 2003 SNMP 애플리케이션의 성능 문제가 발생할 수 있습니다.

이 문제를 해결하려면 애플리케이션을 시작하는 동안 로컬 호스트에서 SnmpMgrOpen 을 호출하여 추가 SNMP 관리자 세션을 만들고 애플리케이션 수명 동안 열어 둡니다. 세션 관리자를 닫으면 연결된 모든 세션이 닫히고 SnmpMgrClose에 대한 호출이 하나만 있으면 됩니다.

Windows Server 2003 SP1: 위의 문제는 Windows 2003 서비스 팩 1에는 적용되지 않습니다.

요구 사항

추가 정보

SNMP 함수

SNMP(Simple Network Management Protocol) 개요

SnmpMgrOpen

SnmpMgrRequest