SnmpGetLastError 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpGetLastError 함수는 호출 애플리케이션의 마지막 오류 코드 값을 반환합니다. 값은 WinSNMP 애플리케이션에서 실행된 마지막 함수 호출이 실패한 이유를 나타냅니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
[in] HSNMP_SESSION session
);
매개 변수
[in] session
WinSNMP 세션에 대한 핸들입니다. 이 매개 변수는 NULL일 수도 있습니다.
경우에 따라 함수 호출이 실패하면 NULL세션 값을 SnmpGetLastError 함수에 전달하여 마지막 오류 코드 값을 검색할 수 있습니다. 이는 세션 매개 변수를 포함하지 않는 함수 호출과 세션 매개 변수 값이 잘못된 경우에 해당합니다. 이러한 경우는 함수 참조 페이지의 반환 값 섹션에 나와 있습니다.
단일 스레드 애플리케이션은 NULL세션 값을 SnmpGetLastError 에 전달하여 전체 애플리케이션에 대한 마지막 오류 정보를 검색할 수 있습니다.
자세한 내용은 다음 설명 및 반환 값 섹션을 참조하세요.
반환 값
세션 매개 변수가 유효한 WinSNMP 세션 핸들인 경우 SnmpGetLastError 함수는 표시된 세션에 대해 발생한 마지막 WinSNMP 오류를 반환합니다.
세션 매개 변수가 NULL인 경우(예: SnmpStartup 함수가 실패하는 경우) SnmpGetLastError는 발생한 마지막 WinSNMP 오류를 반환합니다.
설명
WinSNMP 애플리케이션은 함수가 실패한 직후 SnmpGetLastError 를 호출하여 마지막 오류 코드를 검색해야 합니다. 다른 함수가 실패하면 가장 최근에 실패한 함수에서 설정한 마지막 오류 코드를 덮어씁니다. 자세한 내용은 WinSNMP 오류 코드를 참조하세요.
세션 매개 변수는 다중 스레드 및 단일 스레드 Windows 운영 환경을 모두 수용하지만 한 스레드의 마지막 오류 코드가 다른 스레드에서 마지막 오류 코드를 덮어쓸 가능성이 여전히 존재합니다.
SnmpGetLastError는 다음 조건에서 WinSNMP 애플리케이션에 마지막 오류 코드를 반환할 수 있어야 합니다.
- SnmpStartup 함수가 실패한 후
- SnmpCreateSession 함수가 애플리케이션의 instance 대한 WinSNMP 세션을 만들기 전에
- SnmpClose 함수가 애플리케이션의 instance 대한 모든 WinSNMP 세션을 닫은 후
- SnmpCleanup 함수가 Microsoft WinSNMP 구현에서 WinSNMP 애플리케이션의 연결을 끊은 후
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |