WNetGetProviderNameA 函式 (winnetwk.h)

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

語法

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   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。

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

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

注意

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