Fungsi SnmpCreatePdu (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 SnmpCreatePdu membuat dan menginisialisasi unit data protokol SNMP (PDU).

Sintaks

HSNMP_PDU SNMPAPI_CALL SnmpCreatePdu(
  [in] HSNMP_SESSION session,
  [in] smiINT        PDU_type,
  [in] smiINT32      request_id,
  [in] smiINT        error_status,
  [in] smiINT        error_index,
  [in] HSNMP_VBL     varbindlist
);

Parameter

[in] session

Tangani ke sesi WinSNMP.

[in] PDU_type

Menentukan jenis PDU yang mengidentifikasi operasi SNMP. Parameter ini bisa NULL, atau bisa menjadi salah satu nilai berikut. Jika parameter ini NULL, implementasi Microsoft WinSNMP menyediakan jenis PDU default SNMP_PDU_GETNEXT. Satu-satunya jenis trap PDU yang dapat Anda buat dengan panggilan ke fungsi SnmpCreatePdu adalah PDU trap SNMPv2C.

Nilai	Makna
SNMP_PDU_GET	Cari dan ambil nilai dari variabel SNMP tertentu.
SNMP_PDU_GETNEXT	Cari dan ambil nilai variabel SNMP tanpa mengetahui nama variabel yang tepat.
SNMP_PDU_RESPONSE	Membalas permintaan SNMP_PDU_GET atau SNMP_PDU_GETNEXT.
SNMP_PDU_SET	Simpan nilai dalam variabel SNMP tertentu.
SNMP_PDU_GETBULK	Cari dan ambil beberapa nilai dengan satu permintaan.
SNMP_PDU_TRAP	Memperingatkan sistem manajemen ke peristiwa di bawah SNMPv2C.

[in] request_id

Menentukan nilai numerik unik yang disediakan aplikasi WinSNMP untuk mengidentifikasi PDU. Jika parameter ini NULL, implementasi menetapkan nilai.

[in] error_status

Jika parameter PDU_type sama dengan SNMP_PDU_GETBULK, parameter ini menentukan nilai untuk bidang non_repeaters PDU. Untuk jenis PDU lainnya, parameter ini menentukan nilai untuk bidang error_status PDU. Parameter ini bisa NULL.

[in] error_index

Jika parameter PDU_type sama dengan SNMP_PDU_GETBULK, parameter ini menentukan nilai untuk bidang max_repetitions PDU. Untuk jenis PDU lainnya, parameter ini menentukan nilai untuk bidang error_index PDU. Parameter ini bisa NULL.

[in] varbindlist

Tangani ke struktur yang mewakili daftar pengikatan variabel SNMP. Parameter ini bisa NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke PDU SNMP baru.

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_SESSION_INVALID	Handel sesi tidak valid.
SNMPAPI_PDU_INVALID	Jenis PDU tidak valid.
SNMPAPI_VBL_INVALID	Daftar pengikatan variabel tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Aplikasi WinSNMP harus membuat PDU sebelum memanggil fungsi SnmpSendMsg atau SnmpEncodeMsg .

Semua parameter fungsi SnmpCreatePdu diperlukan. Namun, semua parameter, kecuali parameter sesi , bisa NULL. Dalam hal ini, PDU baru memiliki nilai default berikut.

Bidang	Konten
PDU_type	SNMP_PDU_GETNEXT
request_id	Implementasi menghasilkan nilai numerik.
error_status	SNMP_ERROR_NOERROR
error_index	0
varbindlist	NULL

Aplikasi harus memanggil fungsi SnmpFreePdu untuk merilis sumber daya yang dialokasikan fungsi SnmpCreatePdu untuk PDU baru.

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

Lihat juga

Gambaran Umum API WinSNMP

Bagikan melalui