Partager via

Fonction PathCchAddExtension (pathcch.h)

  • Article

Ajoute une extension de nom de fichier à une chaîne de chemin d’accès.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchAddExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

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 l’extension ajoutée. Cette valeur ne doit pas être NULL.

Note Si une extension de nom de fichier est déjà présente dans la chaîne d’origine, aucune nouvelle extension n’est ajoutée et la chaîne d’origine reste inchangée.

[in] cchPath

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

[in] pszExt

Pointeur vers la chaîne d’extension de nom de fichier. Cette chaîne peut être donnée avec ou sans point précédent (« .ext » ou « ext »).

Valeur retournée

Cette fonction retourne un code HRESULT , y compris ce qui suit.

Code de retour Description
S_OK
 La fonction a réussi. Notez que cela inclut également le cas d’une extension vide, comme un point sans caractères. Dans ce cas, la chaîne d’origine est retournée sans avoir été inchangée.
E_INVALIDARG
 Cette valeur peut être due à plusieurs éléments, tels que le param pszPath défini sur NULL, le cchPath défini sur 0 ou une valeur supérieure à PATHCCH_MAX_CCH, ou la chaîne d’extension contenant des caractères non valides ou non valides.
S_FALSE
 La chaîne d’origine a déjà une extension.
PATHCCH_E_FILENAME_TOO_LONG
 La mémoire tampon est trop petite pour contenir la chaîne retournée.

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