Fungsi SnmpFreePdu (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 SnmpFreePdu merilis sumber daya yang terkait dengan unit data protokol SNMP (PDU) yang dibuat oleh SnmpCreatePdu atau fungsi SnmpDuplicatePdu .
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
Parameter
[in] PDU
Tangani ke PDU SNMP untuk membebaskan.
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. |
|
Handel PDU tidak valid. |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Jika aplikasi memanggil fungsi SnmpClose atau SnmpCleanup , implementasi Microsoft WinSNMP membebaskan semua sumber daya yang dialokasikannya untuk sesi WinSNMP. Namun, disarankan agar aplikasi membebaskan sumber daya individu dengan fungsi WinSNMP yang sesuai dengan sumber daya. Ini mengurangi beban kerja implementasi, dan harus meningkatkan layanan implementasi ke semua aplikasi. Aplikasi harus menggunakan fungsi SnmpFreeVbl untuk membatalkan alokasi sumber daya daftar pengikatan variabel. Untuk informasi tambahan, lihat Konsep Manajemen Data WinSNMP.
Di bawah WinSNMP, entri pengikatan variabel hanya ada dalam daftar pengikatan variabel, bahkan jika daftar pengikatan variabel hanya berisi satu entri.
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 |