Fonction PathCchAddBackslashEx (pathcch.h)

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 ».

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

Voir aussi

PathCchAddBackslash