Fungsi SnmpListen (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 SnmpListen mendaftarkan aplikasi WinSNMP sebagai agen SNMP. Aplikasi agen memanggil fungsi ini untuk menginformasikan implementasi Microsoft WinSNMP bahwa entitas akan bertindak dalam peran agen SNMP. Aplikasi juga memanggil fungsi ini untuk menginformasikan implementasi ketika entitas tidak akan lagi bertindak dalam peran ini. Fungsi SnmpListen adalah elemen dari WINSNMP API, versi 2.0.
Sintaks
SNMPAPI_STATUS SNMPAPI_CALL SnmpListen(
[in] HSNMP_ENTITY hEntity,
[in] SNMPAPI_STATUS lStatus
);
Parameter
[in] hEntity
Tangani ke entitas WinSNMP untuk memberi tahu ketika implementasi Microsoft WinSNMP menerima pesan permintaan SNMP (PDU) masuk. Parameter ini mengidentifikasi aplikasi agen. Untuk informasi selengkapnya, lihat bagian Keterangan dan Nilai Pengembalian berikut ini.
Saat Anda memanggil fungsi SnmpCreateSession , Anda dapat menentukan apakah implementasi harus menggunakan pesan pemberitahuan jendela atau fungsi SNMPAPI_CALLBACK untuk memberi tahu aplikasi saat pesan SNMP atau peristiwa asinkron tersedia.
[in] lStatus
Menentukan variabel bilangan bulat panjang yang tidak ditandatangani yang menunjukkan apakah entitas WinSNMP yang diidentifikasi oleh parameter hEntity bertindak dalam peran agen SNMP, atau jika tidak lagi bertindak dalam peran ini. Parameter ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
|
Entitas WinSNMP yang ditentukan berfungsi dalam peran agen. |
|
Entitas WinSNMP yang ditentukan tidak berfungsi dalam peran agen. |
Meneruskan nilai SNMPAPI_OFF merilis sumber daya yang dialokasikan untuk entitas dan port yang menetapkannya. Untuk informasi selengkapnya, 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 hEntity tidak valid. Parameter ini harus merupakan handel yang dikembalikan oleh panggilan sebelumnya ke fungsi SnmpStrToEntity . |
|
Parameter lStatus tidak valid. |
|
Entitas yang ditentukan oleh parameter hEntity sudah berfungsi dalam peran agen SNMP. |
|
Ada kesalahan lapisan transportasi jaringan. Soket tidak dapat dibuat untuk entitas yang ditentukan oleh parameter hEntity . |
|
Kesalahan terjadi di lapisan transportasi jaringan saat mencoba mengikat soket untuk entitas yang ditentukan oleh parameter hEntity . |
|
Terjadi kesalahan yang tidak diketahui atau tidak terdefinis. |
Keterangan
Saat Anda menentukan entitas, Anda secara eksplisit menentukan keluarga alamat, alamat antarmuka, dan port untuk entitas. Ini karena WinSNMP menetapkan atribut ini ke setiap entitas WinSNMP sebagai akibat dari panggilan ke fungsi SnmpStrToEntity . Implementasi menggunakan alamat dan pengaturan port yang saat ini ditetapkan ke entitas yang ditentukan oleh parameter hEntity saat mengirim pemberitahuan ke aplikasi agen. Untuk informasi selengkapnya, lihat SnmpSetPort.
Ketika Anda memanggil fungsi SnmpClose untuk sesi WinSNMP dan fungsi SnmpCleanup untuk aplikasi WinSNMP, Anda harus merilis semua port yang terkait dengan aplikasi agen WinSNMP.
Untuk informasi selengkapnya tentang aplikasi manajemen SNMP dan aplikasi agen, lihat Mendaftarkan Aplikasi Agen SNMP dan Tentang SNMP.
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 |