Fungsi SnmpDeleteVb (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 WinSNMP SnmpDeleteVb menghapus entri pengikatan variabel dari daftar pengikatan variabel.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index
);
Parameter
[in] vbl
Tangani ke daftar pengikatan variabel untuk diperbarui.
[in] index
Menentukan variabel bilangan bulat panjang yang tidak ditandatangani yang mengidentifikasi entri pengikatan variabel untuk dihapus. Variabel ini berisi posisi entri pengikatan variabel, dalam daftar pengikatan variabel.
Nilai yang valid untuk parameter ini berada dalam rentang dari 1 hingga n, di mana 1 menunjukkan entri pengikatan variabel pertama dalam daftar pengikatan variabel, dan n adalah jumlah total entri dalam daftar pengikatan variabel. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan SNMPAPI_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError. Fungsi SnmpGetLastError dapat mengembalikan salah satu kesalahan berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Fungsi SnmpStartup tidak berhasil diselesaikan. |
|
Terjadi kesalahan selama alokasi memori. |
|
Parameter indeks tidak valid. |
|
Parameter vbl tidak valid. |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Aplikasi WinSNMP dapat menggunakan fungsi SnmpDeleteVb untuk menghapus entri pengikatan variabel yang tidak valid. Ketika unit data protokol (PDU) SNMP_PDU_RESPONSE menyertakan kesalahan yang menunjukkan entri pengikatan variabel yang tidak valid, aplikasi dapat memanggil SnmpDeleteVb untuk menghapus entri. Kemudian aplikasi dapat mengirim ulang permintaan PDU dengan panggilan ke fungsi SnmpSendMsg , tanpa entri pengikatan variabel yang tidak valid dalam daftar pengikatan variabel. PERMINTAAN PDU mencakup jenis data PDU SNMP_PDU_GET, SNMP_PDU_GETNEXT, dan SNMP_PDU_GETBULK.
Setelah fungsi SnmpDeleteVb menghapus entri pengikatan variabel, nilai indeks semua entri setelah entri yang dihapus akan mengalami penurunan satu per satu. Panggilan ke fungsi SnmpCountVbl mengembalikan jumlah total entri baru dalam daftar pengikatan variabel. Total baru adalah satu kurang dari jumlah yang dikembalikan oleh panggilan ke SnmpCountVbl sebelum panggilan saat ini ke SnmpDeleteVb.
Jika aplikasi WinSNMP memanggil fungsi SnmpDeleteVb dan menghapus entri pengikatan variabel terakhir dalam daftar pengikatan variabel, hasilnya adalah daftar pengikatan variabel kosong. Daftar pengikatan variabel masih memiliki handel yang valid dan aplikasi WinSNMP harus merilis handel dengan panggilan ke fungsi SnmpFreeVbl .
Berikut ini adalah nilai yang valid untuk digunakan untuk parameter indeks :
- Nilai yang dikembalikan dari panggilan ke fungsi SnmpCountVbl
- Bidang indeks kesalahan PDU SNMP_PDU_RESPONSE yang dikembalikan oleh panggilan ke fungsi SnmpRecvMsg
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 |