Fungsi WNetSetLastErrorA (npapi.h)

Mengatur informasi kesalahan yang diperluas. Penyedia jaringan harus memanggil fungsi ini alih-alih SetLastError.

Jika perlu, Router Beberapa Penyedia (MPR) memanggil SetLastError untuk mengatur kesalahan Windows yang dikembalikan dari penyedia jaringan.

Sintaks

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR lpProviders
);

Parameter

[in] err

Kesalahan yang terjadi. Ini adalah kode kesalahan khusus jaringan.

[in] lpError

String yang menjelaskan kesalahan khusus jaringan.

[in] lpProviders

String yang menamai penyedia jaringan yang memunculkan kesalahan.

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi ini diimplementasikan oleh sistem operasi Windows dan dapat dipanggil oleh penyedia jaringan.

Penyedia harus menggunakan fungsi ini untuk melaporkan kesalahan yang berisi informasi khusus penyedia. Informasi kesalahan disimpan sampai ditimpa oleh panggilan lain ke WNetSetLastError di utas yang sama.

Cara yang disarankan untuk fungsi penyedia untuk menangani kesalahan umum adalah dengan menggunakan pernyataan berikut.

return(providerError);

Dalam pernyataan ini, providerError adalah kode kesalahan Windows, seperti salah satu kode pengembalian yang tercantum untuk API penyedia dalam dokumen ini.

Untuk kesalahan khusus penyedia, penyedia harus melakukan hal berikut.

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName) ;
return(ERROR_EXTENDED_ERROR) ;

Dalam hal ini, providerError adalah kode kesalahan khusus penyedia.

Penyedia tidak perlu memanggil SetLastError sebelum kembali dari fungsi penyedia. MPR memanggil SetLastError untuk mengatur kesalahan Windows yang dikembalikan dari penyedia jika diperlukan untuk memenuhi aplikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	npapi.h
Pustaka	Mpr.lib
DLL	Mpr.dll