SNMPAPI_CALLBACK fungsi panggilan balik (winsnmp.h)

[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.]

Implementasi Microsoft WinSNMP memanggil fungsi SNMPAPI_CALLBACK untuk memberi tahu sesi WinSNMP bahwa pesan SNMP atau peristiwa asinkron tersedia.

SNMPAPI_CALLBACK adalah tempat penampung untuk nama fungsi panggilan balik yang ditentukan aplikasi atau pustaka.

Sintaks

SNMPAPI_CALLBACK SnmpapiCallback;

SNMPAPI_STATUS SnmpapiCallback(
  [in] HSNMP_SESSION hSession,
  [in] HWND hWnd,
  [in] UINT wMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
  [in] LPVOID lpClientData
)
{...}

Parameter

[in] hSession

Tangani ke sesi WinSNMP.

[in] hWnd

Tangani ke jendela aplikasi WinSNMP untuk memberi tahu ketika permintaan asinkron selesai, atau ketika pemberitahuan trap terjadi. Parameter ini tidak memiliki signifikansi untuk sesi WinSNMP, tetapi implementasi selalu meneruskan nilai ke fungsi panggilan balik.

[in] wMsg

Menentukan bilangan bulat yang tidak ditandatangani yang mengidentifikasi pesan pemberitahuan untuk dikirim ke jendela aplikasi WinSNMP. Parameter ini tidak memiliki signifikansi untuk sesi WinSNMP, tetapi implementasi selalu meneruskan nilai ke fungsi panggilan balik.

[in] wParam

Menentukan nilai 32-bit yang ditentukan aplikasi yang mengidentifikasi jenis pemberitahuan. Jika parameter ini sama dengan nol, pesan SNMP tersedia untuk sesi tersebut. Aplikasi harus memanggil fungsi SnmpRecvMsg untuk mengambil pesan. Jika parameter ini tidak sama dengan nol, parameter menunjukkan pemberitahuan peristiwa asinkron untuk sesi tersebut. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

[in] lParam

Menentukan nilai 32-bit yang ditentukan aplikasi yang menentukan pengidentifikasi permintaan PDU yang sedang diproses.

[in] lpClientData

Jika parameter lpClientData bukan NULL pada panggilan ke fungsi SnmpCreateSession untuk sesi ini, parameter ini adalah penunjuk ke data yang ditentukan aplikasi.

Mengembalikan nilai

Fungsi harus mengembalikan SNMPAPI_SUCCESS untuk melanjutkan eksekusi aplikasi. Jika fungsi mengembalikan nilai lain, implementasi merespons seolah-olah aplikasi yang disebut fungsi SnmpClose untuk sesi yang ditunjukkan.

Keterangan

Ketika implementasi menjalankan kebijakan transmisi ulang untuk aplikasi WinSNMP dan waktu habis transmisi terjadi, implementasi menginformasikan sesi kesalahan. Dalam situasi ini nilai parameter wParam akan SNMPAPI_TL_TIMEOUT. Untuk daftar kesalahan lapisan transportasi lainnya, lihat halaman referensi untuk fungsi SnmpRegister, SnmpSendMsg, dan SnmpRecvMsg .

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

Lihat juga

SnmpClose

SnmpCreateSession

Fungsi WinSNMP

Gambaran Umum API WinSNMP