Fungsi SnmpClose (winsnmp.h)

[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 SnmpClose memungkinkan implementasi Microsoft WinSNMP untuk membatalkan alokasi memori, sumber daya, dan struktur data yang terkait dengan sesi WinSNMP. Fungsi WinSNMP SnmpClose juga menutup mekanisme komunikasi implementasi yang dibuka sebagai akibat dari panggilan ke fungsi SnmpCreateSession .

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
  [in] HSNMP_SESSION session
);

Parameter

[in] session

Tangani sesi WinSNMP untuk menutup.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. 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_SESSION_INVALID	Parameter sesi tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Disarankan agar aplikasi WinSNMP memanggil fungsi SnmpClose sekali untuk setiap sesi yang dibuka aplikasi menggunakan fungsi SnmpCreateSession . Jika aplikasi WinSNMP berakhir secara tak terduga, aplikasi harus memanggil SnmpCleanup sebelum dihentikan untuk memungkinkan implementasi untuk membatalkan semua sumber daya. Implementasi memproses satu panggilan SnmpCleanup seolah-olah itu adalah serangkaian panggilan SnmpClose , satu panggilan untuk setiap sesi yang dibuka sebagai akibat dari panggilan ke SnmpCreateSession.

Ketika implementasi menutup sesi, ia membuang semua permintaan dan balasan asinkron masuk dan keluar yang luar biasa untuk sesi tersebut. Untuk informasi tambahan, lihat Sesi WinSNMP.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

SnmpCleanup

SnmpCreateSession

Fungsi WinSNMP

Gambaran Umum API WinSNMP