Fungsi SnmpSetVb (winsnmp.h)

Artikel
03/15/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 SnmpSetVb mengubah entri pengikatan variabel dalam daftar pengikatan variabel. Fungsi ini juga menambahkan entri pengikatan variabel baru ke daftar pengikatan variabel yang ada.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
  [in] HSNMP_VBL   vbl,
  [in] smiUINT32   index,
  [in] smiLPCOID   name,
  [in] smiLPCVALUE value
);

Parameter

[in] vbl

Tangani ke daftar pengikatan variabel untuk diperbarui.

[in] index

Menentukan variabel bilangan bulat panjang yang tidak ditandatangani yang berisi posisi entri pengikatan variabel, dalam daftar pengikatan variabel, jika ini adalah operasi pembaruan. Jika ini adalah operasi penampan, parameter ini harus sama dengan nol. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] name

Penunjuk ke struktur smiOID yang mewakili nama variabel untuk ditambahkan atau diubah. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] value

Pointer ke struktur smiVALUE . Struktur berisi nilai yang terkait dengan variabel yang ditentukan oleh parameter nama .

Nilai kembali

Jika fungsi berhasil, nilai pengembalian adalah posisi entri pengikatan variabel yang diperbarui atau ditambahkan dalam daftar pengikatan variabel. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

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
SNMPAPI_NOT_INITIALIZED	Fungsi SnmpStartup tidak berhasil diselesaikan.
SNMPAPI_ALLOC_ERROR	Terjadi kesalahan selama alokasi memori.
SNMPAPI_VBL_INVALID	Parameter vbl tidak valid.
SNMPAPI_INDEX_INVALID	Parameter indeks tidak valid.
SNMPAPI_OID_INVALID	Parameter nama tidak valid.
SNMPAPI_SYNTAX_INVALID	Anggota sintaks struktur yang ditujukkan oleh parameter nilai tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Nilai yang valid untuk rentang parameter indeks dari nol hingga n. Nilai nol menunjukkan operasi penampan. Nilai n adalah jumlah total entri pengikatan variabel dalam daftar pengikatan variabel. Aplikasi WinSNMP harus memanggil fungsi SnmpCountVbl sebelum memanggil SnmpSetVb untuk mendapatkan jumlah total entri pengikatan variabel.

Jika fungsi berhasil melakukan operasi pembaruan, nilai yang dikembalikan sama dengan nilai parameter indeks . Jika fungsi menambahkan entri pengikatan variabel, nilai yang dikembalikan adalah n + 1.

Jika parameter nama bukan NULL, tetapi parameter nilai adalah NULL, implementasi Microsoft WinSNMP menginisialisasi entri pengikatan variabel baru dengan anggota nilai diatur ke NULL dan dengan anggota sintaks diatur ke SNMP_SYNTAX_.

Jika parameter indeks tidak sama dengan nol, dan parameter nama adalah NULL, implementasi Microsoft WinSNMP hanya memperbarui nilai variabel yang diacu oleh parameter indeks .

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

Lihat juga

SnmpCountVbl

Fungsi WinSNMP

Gambaran Umum API WinSNMP

smiOID

smiVALUE

Bagikan melalui