Fungsi WNetGetLastErrorA (winnetwk.h)

  • Artikel

Fungsi WNetGetLastError mengambil kode kesalahan yang diperluas terbaru yang ditetapkan oleh fungsi WNet. Penyedia jaringan melaporkan kode galat ini; umumnya tidak akan menjadi salah satu kesalahan yang disertakan dalam file header SDK WinError.h.

Sintaks

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

Parameter

[out] lpError

Penunjuk ke variabel yang menerima kode kesalahan yang dilaporkan oleh penyedia jaringan. Kode kesalahan khusus untuk penyedia jaringan.

[out] lpErrorBuf

Penunjuk ke buffer yang menerima string yang dihentikan null yang menjelaskan kesalahan.

[in] nErrorBufSize

Ukuran buffer yang ditujukkan oleh parameter lpErrorBuf , dalam karakter. Jika buffer terlalu kecil untuk string kesalahan, string dipotong tetapi masih dihentikan null. Penyangga minimal 256 karakter disarankan.

[out] lpNameBuf

Penunjuk ke buffer yang menerima string yang dihentikan null mengidentifikasi penyedia jaringan yang memunculkan kesalahan.

[in] nNameBufSize

Ukuran buffer yang diacu oleh parameter lpNameBuf , dalam karakter. Jika buffer terlalu kecil untuk string kesalahan, string dipotong tetapi masih dihentikan null.

Nilai kembali

Jika fungsi berhasil, dan mendapatkan kesalahan terakhir yang dilaporkan penyedia jaringan, nilai yang dikembalikan NO_ERROR.

Jika pemanggil memasok buffer yang tidak valid, nilai yang dikembalikan ERROR_INVALID_ADDRESS.

Keterangan

Fungsi WNetGetLastError mengambil kesalahan yang khusus untuk penyedia jaringan. Anda dapat memanggil WNetGetLastError saat fungsi WNet mengembalikan ERROR_EXTENDED_ERROR.

Seperti fungsi GetLastError , WNetGetLastError mengembalikan informasi kesalahan yang diperluas, yang dipertahankan berdasarkan per utas. Tidak seperti GetLastError, fungsi WNetGetLastError dapat mengembalikan string untuk melaporkan kesalahan yang tidak dijelaskan oleh kode kesalahan yang ada di WinError.h.

Untuk informasi selengkapnya tentang menggunakan penangan kesalahan yang ditentukan aplikasi yang memanggil fungsi WNetGetLastError , lihat Mengambil Kesalahan Jaringan.

Catatan

Header winnetwk.h mendefinisikan WNetGetLastError sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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 winnetwk.h
Pustaka Mpr.lib
DLL Mpr.dll

Lihat juga

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows