PathAddBackslashW, fonction (shlwapi.h)

Article
11/20/2024

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 source a déjà une barre oblique inverse de fin, aucune barre oblique inverse n’est ajoutée.

Remarque Utilisation incorrecte de cette fonction peut entraîner un dépassement de mémoire tampon. Nous vous recommandons d’utiliser la fonction pathCchAddBackslash ou PathCchAddBackslashEx à sa place.

Syntaxe

LPWSTR PathAddBackslashW(
  [in, out] LPWSTR pszPath
);

Paramètres

[in, out] pszPath

Type : LPTSTR

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

Valeur de retour

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

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via