PathCchAppend, fonction (pathcch.h)

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

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.

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

Voir aussi

PathCchAppendEx