Fungsi SnmpSetPduData (winsnmp.h)

Artikel
03/15/2023

[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 SnmpSetPduData memperbarui bidang data yang dipilih di unit data protokol SNMP (PDU) yang ditentukan.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPduData(
  [in] HSNMP_PDU       PDU,
  [in] const smiINT    *PDU_type,
  [in] const smiINT32  *request_id,
  [in] const smiINT    *non_repeaters,
  [in] const smiINT    *max_repetitions,
  [in] const HSNMP_VBL *varbindlist
);

Parameter

[in] PDU

Menangani ke PDU SNMP.

[in] PDU_type

Penunjuk ke variabel dengan nilai untuk memperbarui bidang PDU_type dari PDU yang ditentukan. Parameter ini juga bisa NULL.

[in] request_id

Arahkan ke variabel dengan nilai untuk memperbarui bidang request_id PDU yang ditentukan. Parameter ini juga bisa NULL.

[in] non_repeaters

Jika parameter PDU_type sama dengan SNMP_PDU_GETBULK, parameter ini menunjuk ke variabel dengan nilai untuk memperbarui bidang non_repeaters dari PDU yang ditentukan. Implementasi Microsoft WinSNMP mengabaikan parameter ini untuk jenis PDU lainnya. Parameter ini juga bisa NULL.

[in] max_repetitions

Jika parameter PDU_type sama dengan SNMP_PDU_GETBULK, parameter ini menunjuk ke variabel dengan nilai untuk memperbarui bidang max_repetitions dari PDU yang ditentukan. Implementasi mengabaikan parameter ini untuk jenis PDU lainnya. Parameter ini juga bisa NULL.

[in] varbindlist

Penunjuk ke variabel dengan nilai yang memperbarui handel ke bidang daftar pengikatan variabel dari PDU yang ditentukan. Parameter ini juga bisa NULL.

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, hubungi 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_PDU_INVALID	Jenis PDU tidak valid.
SNMPAPI_VBL_INVALID	Daftar pengikatan variabel tidak valid.
SNMPAPI_NOOP	Semua parameter input adalah NULL. Operasi SNMP tidak dilakukan.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Semua parameter fungsi SnmpSetPduData diperlukan. Namun, semua parameter, kecuali parameter PDU , bisa NULL. Jika aplikasi WinSNMP melewati NULL dalam parameter, SnmpSetPduData tidak memperbarui bidang yang sesuai di PDU. Karena SnmpSetPduData meneruskan parameter sebagai pointer ke nilai, aplikasi masih dapat memperbarui bidang PDU dengan NULL.

Nilai satu bidang PDU dapat valid sendiri, tetapi mungkin tidak valid dalam kombinasi dengan nilai untuk bidang lain. Implementasi memvalidasi PDU dan elemen pesan lainnya ketika aplikasi memanggil fungsi SnmpSendMsg atau SnmpEncodeMsg . Implementasi menolak PDUs yang tidak valid.

Satu-satunya jenis trap PDU yang dapat Anda perbarui dengan panggilan ke fungsi SnmpSetPduData adalah SNMPv2C trap PDU.

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

SnmpEncodeMsg

SnmpSendMsg

Fungsi WinSNMP

Gambaran Umum API WinSNMP

Bagikan melalui