PathCchStripToRoot, fonction (pathcch.h)

Supprime tous les éléments de fichier et de répertoire d’un chemin d’accès à l’exception des informations racine.

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchStripToRoot(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Paramètres

[in, out] pszPath

Pointeur vers la chaîne de chemin d’accès. Lorsque cette fonction retourne correctement, cette chaîne contient uniquement les informations racine extraites de ce chemin.

[in] cchPath

Taille de la mémoire tampon pointée vers pszPath, en caractères.

Valeur retournée

Cette fonction retourne S_OK si le chemin a été tronqué, S_FALSE si le chemin n’était déjà qu’une racine ou un code d’échec HRESULT .

Remarques

Voici quelques exemples de l’effet de cette fonction :

Configuration requise