Fungsi SnmpFreeEntity (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 WinSNMP SnmpFreeEntity merilis sumber daya yang terkait dengan entitas manajemen SNMP.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
[in] HSNMP_ENTITY entity
);
Parameter
[in] entity
Tangani ke entitas manajemen SNMP yang akan merilis sumber dayanya.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah SNMPAPI_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah 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 |
|---|---|
|
Fungsi SnmpStartup tidak berhasil diselesaikan. |
|
Terjadi kesalahan selama alokasi memori. |
|
Parameter entitas tidak valid. |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Ketika aplikasi WinSNMP memanggil fungsi SnmpClose atau fungsi SnmpCleanup , implementasi Microsoft WinSNMP membebaskan semua sumber daya yang dialokasikan untuk sesi WinSNMP. Namun, disarankan agar aplikasi WinSNMP membebaskan sumber daya individu dengan menggunakan fungsi WinSNMP yang sesuai dengan sumber daya. Misalnya, aplikasi harus memanggil fungsi SnmpFreeEntity untuk merilis sumber daya yang dialokasikan oleh panggilan ke fungsi SnmpStrToEntity . Ini mengurangi beban kerja implementasi, dan harus meningkatkan layanan implementasi ke semua aplikasi.
Untuk informasi tambahan, lihat Konsep Manajemen Data 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 |