Fungsi SnmpGetLastError (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 SnmpGetLastError mengembalikan nilai kode kesalahan terakhir aplikasi panggilan. Nilai menunjukkan alasan mengapa panggilan fungsi terakhir yang dijalankan oleh aplikasi WinSNMP gagal.

Sintaks

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
  [in] HSNMP_SESSION session
);

Parameter

[in] session

Tangani ke sesi WinSNMP. Parameter ini juga bisa NULL.

Dalam kasus tertentu, ketika panggilan fungsi gagal, Anda dapat meneruskan nilai sesiNULL ke fungsi SnmpGetLastError untuk mengambil nilai kode kesalahan terakhir. Ini berlaku untuk panggilan fungsi yang tidak melibatkan parameter sesi , dan kasus di mana nilai parameter sesi tidak valid. Kasus-kasus ini dicatat di bagian Nilai Pengembalian pada halaman referensi fungsi.

Aplikasi utas tunggal dapat meneruskan nilai sesiNULL ke SnmpGetLastError untuk mengambil informasi kesalahan terakhir untuk seluruh aplikasi.

Untuk informasi selengkapnya, lihat bagian Remarks dan Return Values berikut ini.

Mengembalikan nilai

Jika parameter sesi adalah handel sesi WinSNMP yang valid, fungsi SnmpGetLastError mengembalikan kesalahan WinSNMP terakhir yang terjadi untuk sesi yang ditunjukkan.

Jika parameter sesi adalah NULL — misalnya, jika fungsi SnmpStartup gagal, SnmpGetLastError mengembalikan kesalahan WinSNMP terakhir yang terjadi.

Keterangan

Aplikasi WinSNMP harus memanggil SnmpGetLastError segera setelah fungsi gagal, untuk mengambil kode kesalahan terakhir. Jika fungsi lain gagal, fungsi ini menimpa kode kesalahan terakhir yang ditetapkan oleh fungsi yang terakhir gagal. Untuk informasi selengkapnya, lihat Kode Kesalahan WinSNMP.

Meskipun parameter sesi mengakomodasi lingkungan operasi Windows multithread dan single-thread, potensi masih ada untuk kode kesalahan terakhir dari satu utas untuk menimpa kode kesalahan terakhir dari utas lain.

Perhatikan bahwa SnmpGetLastError harus dapat mengembalikan kode kesalahan terakhir ke aplikasi WinSNMP dalam kondisi berikut:

Setelah fungsi SnmpStartup gagal
Sebelum fungsi SnmpCreateSession membuat sesi WinSNMP apa pun untuk instans aplikasi
Setelah fungsi SnmpClose menutup semua sesi WinSNMP untuk instans aplikasi
Setelah fungsi SnmpCleanup memutuskan sambungan aplikasi WinSNMP dari implementasi Microsoft 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