Fonction PathCchRemoveBackslash (pathcch.h)

Article
03/01/2024

Supprime la barre oblique inverse de fin de la fin d’une chaîne de chemin d’accès.

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

Note Cette fonction, ou PathCchRemoveBackslashEx, doit être utilisée à la place de PathRemoveBackslash pour empêcher la possibilité d’un dépassement de mémoire tampon.

Syntaxe

WINPATHCCHAPI HRESULT PathCchRemoveBackslash(
  [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, la chaîne contient le chemin d’accès avec toute barre oblique inverse de fin supprimée. Si aucune barre oblique inverse de fin n’a été trouvée, la chaîne est inchangée.

[in] cchPath

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

Valeur retournée

Cette fonction retourne S_OK si la fonction a réussi, S_FALSE si la chaîne était un chemin racine ou si aucune barre oblique inverse n’a été trouvée, ou un code d’erreur dans le cas contraire.

Remarques

Cette fonction ne supprime pas la barre oblique inverse d’une chaîne de chemin racine, telle que « C : ».

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