WNetGetProviderNameW 函式（winnetwk.h）

WNetGetProviderName 函式會取得特定網路類型的提供者名稱。

語法

DWORD WNetGetProviderNameW(
  [in]      DWORD   dwNetType,
  [out]     LPWSTR  lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

[in] dwNetType

網路特有的網路類型。如果兩個網路宣告相同類型，則函式會先傳回載入的提供者名稱。只會使用網路類型的高字。如果網路報告低字中的子類型，則會忽略它。

您可以在頭檔 Winnetwk.h 中找到網路類型的完整清單。

[out] lpProviderName

接收網路提供者名稱之緩衝區的指標。

[in, out] lpBufferSize

傳遞至函式的緩衝區大小，以字元為單位。如果傳回值是ERROR_MORE_DATA，lpBufferSize 傳回保留提供者名稱所需的緩衝區大小。

Windows Me/98/95：緩衝區的大小是以位元組為單位，而不是字元。此外，緩衝區長度必須至少為1個字節。

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值是系統錯誤碼，例如下列其中一個值。

傳回碼	描述
ERROR_MORE_DATA	緩衝區太小，無法保存網路提供者名稱。
ERROR_NO_NETWORK	網路無法使用。
ERROR_INVALID_ADDRESS	lpProviderName 參數或 lpBufferSize 參數無效。

注意

winnetwk.h 標頭會根據 UNICODE 預處理器常數的定義，將 WNetGetProviderName 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winnetwk.h
連結庫	Mpr.lib
DLL	Mpr.dll