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에는 적용되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgmtapi.h |
| 라이브러리 | Mgmtapi.lib |
| DLL | Mgmtapi.dll |