Fungsi WinSNMP

  • Artikel

[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 yang digunakan dengan WinSNMP termasuk dalam pengelompokan fungsional berikut. Daftar alfabet mengikuti.

Fungsi Komunikasi WinSNMP

Fungsi komunikasi WinSNMP menyediakan antarmuka antara aplikasi WinSNMP panggilan dan implementasi Microsoft WinSNMP. Implementasi menangani komunikasi antara aplikasi dan entitas manajemen lainnya.

Fungsi Deskripsi
SnmpCancelMsg Meminta agar implementasi Microsoft WinSNMP membatalkan upaya pengiriman ulang dan pemberitahuan waktu habis untuk pesan permintaan SNMP.
SnmpCleanup Menginformasikan implementasi bahwa aplikasi terputus dan tidak lagi memerlukan sumber daya yang dialokasikan.
SnmpCleanupEx Melakukan pembersihan ketika tidak ada panggilan berhasil yang luar biasa ke SnmpStartup atau SnmpStartupEx dalam aplikasi WinSNMP.
SnmpClose Memungkinkan implementasi untuk membatalkan alokasi sumber daya yang terkait dengan sesi, dan untuk menutup mekanisme komunikasi.
SnmpCreateSession Meminta implementasi untuk membuka sesi WinSNMP dan mengalokasikan mekanisme sumber daya dan komunikasi. Saat mengembangkan aplikasi WinSNMP baru, disarankan agar Anda memanggil fungsi SnmpCreateSession untuk membuka sesi WinSNMP alih-alih memanggil fungsi SnmpOpen .
SnmpListen Mendaftarkan atau membatalkan pendaftaran aplikasi WinSNMP sebagai agen SNMP.
SnmpBuka Meminta implementasi untuk membuka sesi WinSNMP dan mengalokasikan mekanisme sumber daya dan komunikasi. Saat mengembangkan aplikasi WinSNMP baru, disarankan agar Anda memanggil fungsi SnmpCreateSession untuk membuka sesi WinSNMP alih-alih memanggil fungsi SnmpOpen .
SnmpRecvMsg Mengembalikan pesan SNMP dan data dan pemberitahuan trap yang luar biasa.
SnmpRegister Menginformasikan implementasi bahwa aplikasi perlu mendaftar atau membatalkan pendaftaran untuk perangkap dan pemberitahuan.
SnmpSendMsg Meminta agar implementasi mengirimkan unit data protokol.
SnmpStartup Memberi tahu implementasi untuk melakukan prosedur inisialisasi untuk aplikasi. Aplikasi harus berhasil memanggil fungsi SnmpStartup sebelum memanggil fungsi WinSNMP lainnya.
SnmpStartupEx Memberi tahu implementasi Microsoft WinSNMP bahwa aplikasi WinSNMP memerlukan layanan implementasi. SnmpStartupEx memungkinkan dukungan untuk beberapa modul perangkat lunak independen yang menggunakan WinSNMP dalam aplikasi yang sama.
SNMPAPI_CALLBACK Memberi tahu sesi WinSNMP bahwa pesan SNMP atau peristiwa asinkron tersedia. Catatan: Fungsi panggilan balik ini hanya berlaku untuk sesi yang dibuka sebagai akibat dari panggilan ke fungsi SnmpCreateSession .

Entitas WinSNMP dan Fungsi Konteks

Fungsi entitas dan konteks WinSNMP memungkinkan aplikasi WinSNMP menentukan nama yang mudah digunakan untuk entitas dan konteks SNMP. Implementasi Microsoft WinSNMP menerjemahkan nama ke komponen SNMPv1 atau SNMPv2C menggunakan database implementasi.

Fungsi Deskripsi
SnmpContextToStr Mengembalikan string yang mengidentifikasi konteks SNMP (sekumpulan sumber daya objek terkelola).
SnmpEntityToStr Mengembalikan string yang mengidentifikasi entitas manajemen SNMP.
SnmpFreeContext Merilis sumber daya yang dialokasikan oleh fungsi SnmpStrToContext untuk konteks SNMP.
SnmpFreeEntity Merilis sumber daya yang dialokasikan oleh fungsi SnmpStrToEntity untuk entitas manajemen SNMP.
SnmpSetPort Mengubah port yang ditetapkan ke entitas tujuan SNMP.
SnmpStrToContext Mengembalikan handel ke informasi konteks SNMP yang khusus untuk implementasi.
SnmpStrToEntity Mengembalikan handel ke informasi entitas manajemen SNMP yang khusus untuk implementasi.

Fungsi Database WinSNMP

Fungsi database WinSNMP menyediakan aplikasi WinSNMP dengan akses ke pengaturan saat ini di penyimpanan informasi administratif implementasi Microsoft WinSNMP. Fungsi-fungsi ini memungkinkan perubahan mode transmisi ulang dan mode terjemahan entitas dan konteks. Fungsi database juga menyediakan aplikasi dengan kemampuan untuk memanipulasi nilai waktu habis dan jumlah coba lagi.

Fungsi Deskripsi
SnmpGetRetransmitMode Mengembalikan pengaturan mode transmisi ulang saat ini.
SnmpGetRetry Mengembalikan nilai jumlah coba lagi, dalam unit, untuk transmisi ulang permintaan pesan SNMP.
SnmpGetTimeout Mengembalikan nilai waktu habis, dalam seratus detik, untuk transmisi permintaan pesan SNMP.
SnmpGetTranslateMode Mengembalikan pengaturan entitas dan mode terjemahan konteks saat ini.
SnmpGetVendorInfo Mengambil informasi yang mengidentifikasi vendor WinSNMP.
SnmpSetRetransmitMode Mengubah mode transmisi ulang.
SnmpSetRetry Mengubah nilai jumlah coba lagi untuk transmisi ulang permintaan pesan SNMP.
SnmpSetTimeout Mengubah nilai batas waktu untuk transmisi permintaan pesan SNMP.
SnmpSetTranslateMode Mengubah mode terjemahan entitas dan konteks.

Fungsi WinSNMP PDU

Fungsi WinSNMP PDU memungkinkan aplikasi WinSNMP untuk mengekstrak dan memperbarui elemen data (atau bidang) PDU. Ini termasuk PDUs yang dikembalikan oleh panggilan ke fungsi SnmpRecvMsg atau fungsi SnmpDecodeMsg . Fungsi PDU juga membangun PDUs untuk digunakan dalam fungsi SnmpSendMsg dan SnmpEncodeMsg .

Fungsi Deskripsi
SnmpCreatePdu Membuat dan menginisialisasi unit data protokol SNMP.
SnmpDuplicatePdu Menduplikasi unit data protokol SNMP.
SnmpFreePdu Merilis sumber daya yang terkait dengan unit data protokol SNMP yang dibuat oleh SnmpCreatePdu atau fungsi SnmpDuplicatePdu .
SnmpGetPduData Mengembalikan elemen data yang dipilih dari unit data protokol SNMP tertentu.
SnmpSetPduData Updates elemen data yang dipilih dalam unit data protokol SNMP tertentu.

Fungsi Utilitas WinSNMP

Fungsi utilitas WinSNMP memungkinkan aplikasi WinSNMP mengelola objek dan pesan SNMP di seluruh antarmuka WinSNMP.

Fungsi Deskripsi
SnmpDecodeMsg Mendekode pesan SNMP yang dikodekan atau diserialisasikan ke dalam komponen konstituennya.
SnmpEncodeMsg Membuat pesan SNMP yang dikodekan.
SnmpFreeDescriptor Menandakan implementasi Microsoft WinSNMP bahwa ia harus membebaskan memori yang dialokasikan untuk deskriptor tertentu.
SnmpGetLastError Mengembalikan nilai kode kesalahan terakhir untuk operasi SNMP terakhir.
SnmpOidCompare Membandingkan dua pengidentifikasi objek SNMP.
SnmpOidCopy Menyalin pengidentifikasi objek SNMP.
SnmpOidToStr Mengonversi representasi biner internal pengidentifikasi objek SNMP ke format string numerik putus-putus.
SnmpStrToOid Mengonversi format string numerik putus-putus dari pengidentifikasi objek SNMP ke representasi biner internalnya.

Fungsi Pengikatan Variabel WinSNMP

Fungsi pengikatan variabel WinSNMP memungkinkan aplikasi WinSNMP membangun dan memanipulasi daftar pengikatan variabel, dan menyertakannya dalam PDUs.

Fungsi Deskripsi
SnmpCountVbl Menghitung entri pengikatan variabel dalam daftar pengikatan variabel tertentu.
SnmpCreateVbl Membuat daftar pengikatan variabel baru.
SnmpDeleteVb Menghapus entri pengikatan variabel dari daftar pengikatan variabel.
SnmpDuplicateVbl Menyalin daftar pengikatan variabel.
SnmpFreeVbl Merilis sumber daya untuk daftar pengikatan variabel yang dialokasikan sebelumnya oleh fungsi SnmpCreateVbl atau SnmpDuplicateVbl .
SnmpGetVb Mengambil informasi dari entri pengikatan variabel tertentu.
SnmpSetVb Mengubah entri pengikatan variabel dalam daftar pengikatan variabel; menambahkan entri pengikatan variabel baru ke daftar pengikatan variabel yang ada.

Daftar Alfabet Fungsi WinSNMP