Fungsi SnmpFreeVbl (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 WinSNMP SnmpFreeVbl merilis sumber daya yang terkait dengan daftar pengikatan variabel. Ini adalah sumber daya yang dialokasikan sebelumnya oleh panggilan ke fungsi SnmpCreateVbl atau fungsi SnmpDuplicateVbl dalam aplikasi WinSNMP.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Parameter

[in] vbl

Tangani ke daftar pengikatan variabel untuk dirilis.

Menampilkan 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_VBL_INVALID	Parameter vbl tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Aplikasi WinSNMP harus merilis sumber daya yang terkait dengan setiap daftar pengikatan variabel. Ini harus dilakukan dengan mencocokkan setiap panggilan ke fungsi SnmpCreateVbl dan SnmpDuplicateVbl dengan panggilan yang sesuai ke fungsi SnmpFreeVbl . Untuk menghindari kebocoran memori, aplikasi WinSNMP harus memanggil SnmpFreeVbl sebelum menggunakan kembali handel ke daftar pengikatan variabel dalam panggilan berikutnya ke SnmpCreateVbl atau SnmpDuplicateVbl.

Jika aplikasi memanggil fungsi SnmpClose atau SnmpCleanup , implementasi Microsoft WinSNMP membebaskan semua sumber daya yang dialokasikannya untuk sesi WinSNMP. Namun, bahkan jika aplikasi tidak menggunakan kembali handel daftar pengikatan variabel, disarankan agar aplikasi membebaskan sumber daya pengikatan variabel individual dengan fungsi SnmpFreeVbl . Ini mengurangi beban kerja implementasi, dan harus meningkatkan layanannya ke semua aplikasi. Untuk informasi tambahan, lihat Konsep Manajemen Data WinSNMP.

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