Fungsi SnmpCleanup (winsnmp.h)

Artikel
08/27/2023

[SNMP tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan Manajemen Jarak Jauh Windows, yang merupakan implementasi Microsoft dari WS-Man.]

Fungsi SnmpCleanup menginformasikan implementasi Microsoft WinSNMP bahwa aplikasi WinSNMP panggilan tidak lagi memerlukan layanan implementasi.

Catatan Aplikasi WinSNMP harus memanggil fungsi SnmpCleanup sebagai fungsi WinSNMP terakhir sebelum berakhir.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpCleanup();

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS. Sampai aplikasi WinSNMP berhasil memanggil kembali fungsi SnmpStartup , panggilan lain ke fungsi WinSNMP mengembalikan SNMPAPI_FAILURE, dengan kode kesalahan SNMPAPI_NOT_INITIALIZED yang diperluas.

Jika fungsi gagal, nilai pengembalian SNMPAPI_FAILURE, tetapi aplikasi WinSNMP tidak perlu mencoba kembali panggilan ke SnmpCleanup. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError yang menentukan nilai NULL dalam parameter sesinya . Fungsi SnmpGetLastError dapat mengembalikan salah satu kesalahan berikut.

Menampilkan kode	Deskripsi
SNMPAPI_NOT_INITIALIZED	Fungsi SnmpStartup tidak berhasil diselesaikan.
SNMPAPI_ALLOC_ERROR	Terjadi kesalahan selama alokasi memori.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Sebelum aplikasi WinSNMP memanggil SnmpCleanup, aplikasi harus memanggil fungsi SnmpClose sekali untuk setiap sesi implementasi terbuka sebagai akibat dari panggilan ke fungsi SnmpCreateSession .

Ketika aplikasi WinSNMP memanggil fungsi SnmpCleanup , implementasi membatalkan alokasi semua sumber daya yang dialokasikan untuk aplikasi. Namun, disarankan agar aplikasi WinSNMP membebaskan sumber daya tertentu yang dialokasikan implementasi untuk itu dengan fungsi WinSNMP yang sesuai dengan sumber daya. Untuk informasi tambahan tentang membebaskan sumber daya individual, lihat SnmpFreeEntity, SnmpFreeVbl, SnmpFreeDescriptor, SnmpFreeContext, dan SnmpFreePdu.

Jika aplikasi WinSNMP harus melakukan keluar darurat, dan memanggil SnmpCleanup tanpa membebaskan sumber daya individu dan tanpa memanggil SnmpClose untuk setiap sesi terbuka, implementasi membatalkan semua sumber daya yang dialokasikan untuk aplikasi WinSNMP. Namun, untuk mengaktifkan fungsionalitas ini dalam implementasi, aplikasi harus tetap memanggil SnmpCleanup.

SnmpCleanup tidak boleh dipanggil ketika DLL aplikasi sedang dalam proses pembongkaran.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winsnmp.h
Pustaka	Wsnmp32.lib
DLL	Wsnmp32.dll