PathIsNetworkPathA 函式 (shlwapi.h)

  • 發行項

判斷路徑字串是否代表網路資源。

語法

BOOL PathIsNetworkPathA(
  [in] LPCSTR pszPath
);

參數

[in] pszPath

類型： LPCTSTR

包含路徑之 null 終止字串的指標，長度上限為MAX_PATH。

傳回值

類型： BOOL

如果字串代表網路資源，則傳回 TRUE ，否則傳回 FALSE 。

備註

PathIsNetworkPath 會將下列兩種類型的路徑解譯為網路路徑。

  • 開頭為兩個反斜杠字元 (\\) 的路徑會解譯為通用命名慣例， (UNC) 路徑。
  • 開頭為字母的路徑，後面接著冒號 (：) 會解譯為掛接的網路驅動器機。 不過， PathIsNetworkPath 無法透過 Microsoft MS-DOS SUBST 命令或 DefineDosDevice 函式辨識對應至驅動器號的網路驅動器機。
注意 函式不會確認指定的網路資源存在、目前可供存取，或使用者有足夠的許可權可存取它。
 

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)