PathAddBackslashA, fonction (shlwapi.h)

Ajoute une barre oblique inverse à la fin d’une chaîne pour créer la syntaxe correcte pour un chemin d’accès. Si le chemin d’accès source comporte déjà une barre oblique inverse de fin, aucune barre oblique inverse n’est ajoutée.

Note Une mauvaise utilisation de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction PathCchAddBackslash ou PathCchAddBackslashEx plus sécurisée à sa place.

 

Syntaxe

LPSTR PathAddBackslashA(
  [in, out] LPSTR pszPath
);

Paramètres

[in, out] pszPath

Type : LPTSTR

Pointeur vers une mémoire tampon avec une chaîne qui représente un chemin. La taille de cette mémoire tampon doit être définie sur MAX_PATH pour garantir qu’elle est suffisamment grande pour contenir la chaîne retournée.

Valeur retournée

Type : LPTSTR

Pointeur qui, lorsque cette fonction retourne correctement, pointe vers le caractère null de fin de la nouvelle chaîne. Si la barre oblique inverse n’a pas pu être ajoutée en raison d’une taille de mémoire tampon insuffisante, cette valeur est NULL.

Remarques

Notes

L’en-tête shlwapi.h définit PathAddBackslash comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)