SnmpFreePdu 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpFreePdu 함수는 SnmpCreatePdu 또는 SnmpDuplicatePdu 함수에서 만든 SNMP PDU(프로토콜 데이터 단위)와 연결된 리소스를 해제합니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
매개 변수
[in] PDU
SNMP PDU에 대한 핸들을 해제합니다.
반환 값
함수가 성공하면 반환 값이 SNMPAPI_SUCCESS.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 세션 매개 변수에서 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
PDU 핸들이 잘못되었습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
애플리케이션이 SnmpClose 또는 SnmpCleanup 함수를 호출하는 경우 Microsoft WinSNMP 구현은 WinSNMP 세션에 할당하는 모든 리소스를 해제합니다. 그러나 애플리케이션은 리소스에 해당하는 WinSNMP 함수를 사용하여 개별 리소스를 해제하는 것이 좋습니다. 이렇게 하면 구현의 작업 부하가 줄어들고 구현의 서비스가 모든 애플리케이션에 향상됩니다. 애플리케이션은 SnmpFreeVbl 함수를 사용하여 변수 바인딩 목록 리소스의 할당을 취소해야 합니다. 자세한 내용은 WinSNMP 데이터 관리 개념을 참조하세요.
WinSNMP에서 변수 바인딩 항목은 변수 바인딩 목록에 하나의 항목만 포함되더라도 변수 바인딩 목록 내에만 존재합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |