Funzione PathCchIsRoot (pathcch.h)

Articolo
03/01/2024

Determina se una stringa di percorso fa riferimento alla radice di un volume.

Questa funzione è diversa da PathIsRoot in quanto accetta percorsi con prefissi "\", "\?" e "\?\UNC".

Sintassi

WINPATHCCHAPI BOOL PathCchIsRoot(
  [in, optional] PCWSTR pszPath
);

Parametri

[in, optional] pszPath

Puntatore alla stringa di percorso.

Valore restituito

Restituisce TRUE se il percorso specificato è una radice o FALSE in caso contrario.

Commenti

Nella tabella seguente viene illustrato il valore restituito PathCchIsRoot per vari percorsi.

Percorso	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

Questa funzione restituisce TRUE per i percorsi, ad esempio "", "X:" o "\\server\share". Percorsi come ".. \path2" o "\\server" restituiscono FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	pathcch.h
Libreria	Pathcch.lib

Condividi tramite