Fungsi SnmpCleanupEx (winsnmp.h)
[SNMP tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan Manajemen Jarak Jauh Windows, yang merupakan implementasi Microsoft dari WS-Man.]
Fungsi SnmpCleanupEx melakukan pembersihan ketika tidak ada panggilan berhasil yang luar biasa ke SnmpStartup atau SnmpStartupEx dalam aplikasi Windows SNMP (WinSNMP). Jika tidak, jumlah referensi internal yang menunjukkan jumlah panggilan keberhasilan yang luar biasa saat ini ke SnmpStartupEx dikurangi.
Fungsi ini harus digunakan alih-alih SnmpCleanup jika Windows Server 2003 dengan Paket Layanan 1 (SP1) atau yang lebih baru diinstal. SnmpCleanupEx memungkinkan dukungan untuk beberapa modul perangkat lunak independen yang menggunakan WinSNMP dalam aplikasi yang sama.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpCleanupEx();
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah SNMPAPI_SUCCESS. Sampai aplikasi WinSNMP berhasil memanggil kembali fungsi SnmpStartupEx yang sesuai dan tidak ada panggilan sukses tambahan yang luar biasa ke SnmpStartup atau SnmpStartupEx, panggilan lain ke fungsi WinSNMP dalam aplikasi yang sama mengembalikan SNMPAPI_FAILURE, dengan kode kesalahan SNMPAPI_NOT_INITIALIZED yang diperluas.
Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE, tetapi aplikasi WinSNMP tidak perlu mencoba kembali panggilan ke SnmpCleanupEx. 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 |
|---|---|
|
Terjadi kesalahan selama alokasi memori. |
|
Fungsi SnmpStartupEx tidak berhasil diselesaikan, atau terjadi kesalahan yang tidak diketahui atau tidak ditentukan. |
Keterangan
Sebelum aplikasi WinSNMP memanggil SnmpCleanupEx, aplikasi harus memanggil fungsi SnmpClose sekali untuk setiap sesi implementasi terbuka sebagai akibat dari panggilan ke fungsi SnmpCreateSession .
Ketika aplikasi WinSNMP memanggil fungsi SnmpCleanupEx , implementasi membatalkan alokasi semua sumber daya yang dialokasikan untuk aplikasi jika juga tidak ada panggilan berhasil yang luar biasa ke SnmpStartup atau SnmpStartupEx. 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 SnmpCleanupEx 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 SnmpCleanupEx.
SnmpCleanupEx 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 |