Fungsi SnmpOpen (winsnmp.h)

Artikel
03/09/2024

[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 SnmpOpen meminta implementasi Microsoft WinSNMP untuk membuka sesi untuk aplikasi WinSNMP. Fungsi WinSNMP ini memungkinkan implementasi untuk mengalokasikan dan menginisialisasi mekanisme memori, sumber daya, struktur data, dan komunikasi. Fungsi SnmpOpen mengembalikan handel ke sesi WinSNMP baru.

Catatan Saat mengembangkan aplikasi WinSNMP baru, disarankan agar Anda memanggil fungsi SnmpCreateSession untuk membuka sesi WinSNMP alih-alih memanggil fungsi SnmpOpen .

Sintaks

HSNMP_SESSION SNMPAPI_CALL SnmpOpen(
  [in] HWND hWnd,
  [in] UINT wMsg
);

Parameter

[in] hWnd

Tangani ke jendela aplikasi WinSNMP untuk memberi tahu ketika permintaan asinkron selesai, atau ketika pemberitahuan trap terjadi.

[in] wMsg

Menentukan bilangan bulat yang tidak ditandatangani yang mengidentifikasi pesan pemberitahuan untuk dikirim ke jendela aplikasi WinSNMP.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah handel yang mengidentifikasi sesi WinSNMP yang dibuka implementasi untuk aplikasi panggilan.

Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError yang menentukan nilai NULL dalam parameter sesinya . 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_HWND_INVALID	Parameter hWnd bukan handel jendela yang valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Fungsi SnmpOpen mengembalikan handel unik untuk setiap sesi WinSNMP yang terbuka dalam aplikasi WinSNMP panggilan. Aplikasi harus menggunakan handel sesi yang dikembalikan SnmpOpen dalam panggilan fungsi WinSNMP lainnya untuk memfasilitasi alokasi dan dealokasi sumber daya oleh implementasi. Ketika implementasi mengalokasikan sumber daya ke sesi individual, implementasi melakukan rilis sumber daya secara teratur sebagai respons terhadap panggilan ke SnmpClose untuk sesi tersebut.

Fungsi SnmpOpen meneruskan ke implementasi handel ke jendela aplikasi dan pengidentifikasi pesan pemberitahuan. Jika komponen wParam dari pesan pemberitahuan yang ditentukan oleh parameter wMsg sama dengan nol, aplikasi WinSNMP harus mengambil unit data protokol masuk (PDU). Aplikasi melakukan ini dengan memanggil fungsi SnmpRecvMsg dengan handel sesi yang dikembalikan oleh SnmpOpen. Jika parameter wParam pesan pemberitahuan tidak sama dengan nol, parameter tersebut mewakili kode kesalahan WinSNMP. Kode kesalahan berlaku untuk PDU yang diidentifikasi oleh pengidentifikasi permintaan dalam parameter lParam pesan pemberitahuan.

Satu aplikasi WinSNMP dapat membuka beberapa sesi WinSNMP. Jika aplikasi membuka beberapa sesi menggunakan handel jendela yang sama, disarankan agar aplikasi WinSNMP menentukan parameter wMsg unik untuk setiap sesi.

Disarankan agar aplikasi WinSNMP memanggil fungsi SnmpClose sekali untuk setiap sesi yang dibuka implementasi sebagai akibat dari panggilan ke fungsi SnmpOpen . Jika aplikasi WinSNMP berakhir secara tak terduga, aplikasi harus memanggil SnmpCleanup sebelum dihentikan untuk memungkinkan implementasi untuk membatalkan semua sumber daya. Implementasi memperlakukan satu panggilan SnmpCleanup seolah-olah itu adalah serangkaian panggilan SnmpClose , satu panggilan untuk setiap sesi implementasi terbuka sebagai akibat dari panggilan ke SnmpOpen.

Untuk informasi tentang membuka sesi WinSNMP dan menentukan metode yang digunakan untuk menginformasikan sesi pesan SNMP yang tersedia dan peristiwa asinkron, lihat SnmpCreateSession. Saat Anda memanggil SnmpCreateSession , Anda dapat menentukan pesan pemberitahuan jendela atau fungsi SNMPAPI_CALLBACK untuk memberi tahu sesi.

Untuk informasi selengkapnya, lihat Sesi WinSNMP.

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