判斷路徑字串是否參考磁碟區的根目錄。
此函式與 PathIsRoot 不同,因為它接受具有 “\”、“\?” 和 “\?\UNC” 前置詞的路徑。
語法
WINPATHCCHAPI BOOL PathCchIsRoot(
[in, optional] PCWSTR pszPath
);
參數
[in, optional] pszPath
路徑字串的指標。
傳回值
如果指定的路徑是根目錄,則傳回 TRUE ,否則傳回 FALSE 。
備註
下表顯示各種路徑的 PathCchIsRoot傳 回值。
| 路徑 | PathCchIsRoot |
|---|---|
| “c:\” | TRUE |
| “c:” | false |
| “c:\path1” | FALSE |
| “\path1” | TRUE |
| “path1” | false |
| “\\path1\path2” | TRUE |
| “\\path1\path2\” | false |
| “\\path1\path2\path3” | FALSE |
| “\\path1” | TRUE |
| “\\path1\” | false |
| "\\" | TRUE |
| “\\?\UNC\” | TRUE |
| “\\?\UNC\path1\path2” | TRUE |
| “\\?\UNC\path1\path2\” | FALSE |
| “\\?\UNC\path1\path2\path3” | FALSE |
| “\\?\UNC\path1” | TRUE |
| “\\?\UNC\path1\” | FALSE |
| “\\?\c:\” | TRUE |
| “\\?\c:” | FALSE |
| “\\?\c:\path1” | false |
| “\\?\Volume{guid}\” | TRUE |
| “\\?\Volume{guid}” | false |
| “\\?\Volume{guid}\path1” | FALSE |
| NULL | false |
| "" | FALSE |
此函式會針對 “”、“X:” 或 “\\server\share” 等路徑傳回 TRUE。 “.. 之類的路徑。\path2“ 或 ”\\server“ 會傳回 FALSE。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | pathcch.h |
| 程式庫 | Pathcch.lib |