Fungsi SnmpFreeContext (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 SnmpFreeContext merilis sumber daya yang terkait dengan konteks SNMP, yang merupakan sekumpulan sumber daya objek terkelola.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
[in] HSNMP_CONTEXT context
);
Parameter
[in] context
Tangani konteks SNMP yang akan merilis sumber dayanya.
Menampilkan 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 konteks 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 fungsi WinSNMP yang sesuai dengan sumber daya. Misalnya, aplikasi harus memanggil fungsi SnmpFreeContext untuk merilis sumber daya yang dialokasikan oleh panggilan ke fungsi SnmpStrToContext . Ini mengurangi beban kerja implementasi, dan harus meningkatkan layanan implementasi 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 |