Fonction PathCchAddBackslashEx (pathcch.h)

Article
03/01/2024

Ajoute une barre oblique inverse à la fin d’une chaîne pour créer la syntaxe appropriée 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.

Cette fonction diffère de PathCchAddBackslash en ce qu’elle peut retourner un pointeur vers la nouvelle extrémité de la chaîne et signaler le nombre de caractères inutilisés restant dans la mémoire tampon.

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

Note Cette fonction, ou PathCchAddBackslash, doit être utilisée à la place de PathAddBackslash pour éviter le risque d’un dépassement de mémoire tampon.

Syntaxe

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [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 mémoire tampon contient la chaîne avec la barre oblique inverse ajoutée. Cette valeur ne doit pas être NULL.

[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 le caractère null de fin à la fin de la chaîne.

[out, optional] pcchRemaining

Pointeur vers une valeur qui, lorsque cette fonction retourne correctement, est défini sur le nombre de caractères inutilisés dans la mémoire tampon de destination, y compris le caractère null de fin.

Valeur retournée

Cette fonction retourne S_OK si la fonction a réussi, S_FALSE si la chaîne de chemin se termine déjà par une barre oblique inverse ou un code d’erreur dans le cas contraire.

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

Voir aussi

PathCchAddBackslash

Partager via