WNetSetLastErrorA 函式 (npapi.h)

設定擴充錯誤資訊。 網路提供者應該呼叫此函式，而不是 SetLastError。

必要時， 多個提供者路由器 (MPR) 呼叫 SetLastError 來設定從網路提供者傳回的 Windows 錯誤。

語法

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

參數

[in] err

發生的錯誤。 這是網路特定的錯誤碼。

[in] lpError

描述網路特定錯誤的字串。

[in] lpProviders

將引發錯誤的網路提供者命名為字串。

傳回值

無

備註

此函式是由 Windows 作業系統實作，可由網路提供者呼叫。

提供者應該使用此函式來報告包含提供者特定信息的錯誤。 錯誤資訊會儲存，直到另一個呼叫相同線程中的 WNetSetLastError 覆寫為止。

提供者函式處理一般錯誤的建議方式是使用下列語句。

return(providerError);

在此語句中，providerError 是 Windows 錯誤碼，例如本檔中所列提供者 API 的其中一個傳回碼。

針對提供者特定的錯誤，提供者應該執行下列動作。

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

在此情況下，providerError 是提供者特定的錯誤碼。

提供者不需要在從提供者函式傳回之前呼叫 SetLastError 。 MPR 會呼叫 SetLastError ，以在必要時設定提供者傳回的 Windows 錯誤，以滿足應用程式。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	npapi.h
程式庫	Mpr.lib
Dll	Mpr.dll