PathCchIsRoot, fonction (pathcch.h)

Article
03/01/2024

Détermine si une chaîne de chemin fait référence à la racine d’un volume.

Cette fonction diffère de PathIsRoot en ce qu’elle accepte les chemins d’accès avec les préfixes « \ », « \ ? » et « \ ?\UNC ».

Syntaxe

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

Paramètres

[in, optional] pszPath

Pointeur vers la chaîne de chemin d’accès.

Valeur retournée

Retourne TRUE si le chemin spécifié est une racine, ou FALSE dans le cas contraire.

Remarques

Le tableau suivant montre la valeur de retour PathCchIsRoot pour différents chemins.

Chemin d’accès	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

Cette fonction retourne TRUE pour les chemins d’accès tels que « », « X : » ou « \\server\share ». Chemins d’accès tels que .. \path2 » ou « \\server » retourne FALSE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	pathcch.h
Bibliothèque	Pathcch.lib

Partager via