Fonction PathCchRemoveBackslashEx (pathcch.h)

Article
03/04/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 PathCchRemoveBackslash en ce qu’elle peut retourner un pointeur vers la nouvelle fin de la chaîne et signaler le nombre de caractères inutilisés restants dans la mémoire tampon.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

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.

[out, optional] ppszEnd

Valeur qui, lorsque cette fonction retourne correctement, reçoit l’adresse d’un pointeur vers la fin de la nouvelle chaîne. Si la chaîne est un chemin racine tel que « C : », le pointeur pointe vers la barre oblique inverse ; sinon, le pointeur pointe vers le caractère null de fin de la chaîne.

[out, optional] pcchRemaining

Pointeur vers une valeur qui, lorsque cette fonction retourne correctement, reçoit le nombre de caractères inutilisés dans la mémoire tampon de destination, y compris le caractère null de fin. Si la chaîne est un chemin racine tel que « C : », ce nombre inclut la barre oblique inverse dans cette chaîne.

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