SnmpCleanupEx 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
SnmpCleanupEx 함수는 WinSNMP(Windows SNMP) 애플리케이션 내에서 SnmpStartup 또는 SnmpStartupEx에 대한 미해결 호출이 없는 경우 정리를 수행합니다. 그렇지 않으면 SnmpStartupEx 에 대한 현재 미해결 호출 수를 나타내는 내부 참조 수가 감소합니다.
Windows Server 2003 SP1(서비스 팩 1) 이상이 설치된 경우 이 함수는 SnmpCleanup 대신 사용해야 합니다. SnmpCleanupEx 를 사용하면 동일한 애플리케이션 내에서 WinSNMP를 사용하는 여러 독립 소프트웨어 모듈을 지원할 수 있습니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpCleanupEx();
반환 값
함수가 성공하면 반환 값이 SNMPAPI_SUCCESS. WinSNMP 애플리케이션이 해당 SnmpStartupEx 함수를 성공적으로 회수하고 SnmpStartup 또는 SnmpStartupEx 에 대한 추가 미해결 성공적인 호출이 없을 때까지 동일한 애플리케이션 내의 WinSNMP 함수 에 대한 다른 호출은 SNMPAPI_NOT_INITIALIZED 확장된 오류 코드와 함께 SNMPAPI_FAILURE 반환합니다.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE WinSNMP 애플리케이션은 SnmpCleanupEx에 대한 호출을 다시 시도할 필요가 없습니다. 확장 오류 정보를 얻으려면 세션 매개 변수에서 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
메모리 할당 중에 오류가 발생했습니다. |
|
SnmpStartupEx 함수가 성공적으로 완료되지 않았거나 알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
WinSNMP 애플리케이션이 SnmpCleanupEx를 호출하기 전에 SnmpCreateSession 함수 호출의 결과로 구현이 열리는 각 세션에 대해 SnmpClose 함수를 한 번 호출해야 합니다.
WinSNMP 애플리케이션이 SnmpCleanupEx 함수를 호출할 때 구현은 SnmpStartup 또는 SnmpStartupEx에 대한 미해결 성공적인 호출이 없는 경우 애플리케이션에 할당된 모든 리소스의 할당을 취소합니다. 그러나 WinSNMP 애플리케이션은 리소스에 해당하는 WinSNMP 함수를 사용하여 구현에서 할당하는 특정 리소스를 해제하는 것이 좋습니다. 개별 리소스를 해제하는 방법에 대한 자세한 내용은 SnmpFreeEntity, SnmpFreeVbl, SnmpFreeDescriptor, SnmpFreeContext 및 SnmpFreePdu를 참조하세요.
WinSNMP 애플리케이션이 비상 종료를 수행해야 하고 개별 리소스를 해제하지 않고 열려 있는 모든 세션에 대해 SnmpClose를 호출하지 않고 SnmpCleanupEx를 호출하는 경우 구현은 WinSNMP 애플리케이션에 할당된 모든 리소스의 할당을 취소합니다. 그러나 구현에서 이 기능을 사용하도록 설정하려면 애플리케이션이 여전히 SnmpCleanupEx를 호출해야 합니다.
애플리케이션 DLL이 언로드 중일 때 SnmpCleanupEx를 호출해서는 안 됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |