PathCchAppend, fonction (pathcch.h)

Article
03/04/2024

Ajoute un chemin à la fin d’un autre.

Cette fonction diffère de PathCchAppendEx en ce que vous êtes limité à un chemin d’accès final de longueur MAX_PATH.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Paramètres

[in, out] pszPath

Pointeur vers une mémoire tampon qui, lors de l’entrée, contient le chemin d’accès d’origine. Lorsque cette fonction retourne correctement, la mémoire tampon contient le chemin d’accès d’origine et le chemin ajouté.

[in] cchPath

Taille de la mémoire tampon pointée vers pszPath, en caractères.

[in, optional] pszMore

Pointeur vers le chemin à ajouter à la fin du chemin d’accès pointé par pszPath. Les chemins UNC et les chemins commençant par la séquence « \ ? » sont acceptés et reconnus comme des chemins complets. Ces chemins remplacent la chaîne pointée par pszPath au lieu d’y être ajouté.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code HRESULT , y compris les éléments suivants.

Code de retour	Description
E_INVALIDARG	PszPath ou pszMore a la valeur NULL, cchPath a la valeur 0 ou cchPath est supérieur à PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG	La chaîne résultante dépasserait PATHCCH_MAX_CCH.
E_OUTOFMEMORY	La fonction n’a pas pu allouer une mémoire tampon de la taille nécessaire.

Remarques

Cette fonction insère une barre oblique inverse entre les deux chaînes, si l’une d’elles n’est pas déjà présente.

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

PathCchAppendEx

Partager via