Partager via

Fonction PathCchRenameExtension (pathcch.h)

  • Article

Remplace l’extension d’un nom de fichier à la fin d’une chaîne de chemin d’accès par une nouvelle extension. Si la chaîne de chemin ne se termine pas par une extension, la nouvelle extension est ajoutée.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [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, cette valeur pointe vers la même chaîne, mais avec l’extension renommée ou ajoutée.

[in] cchPath

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

[in] pszExt

Pointeur vers la nouvelle chaîne d’extension. Le caractère de début « . » est facultatif. Dans le cas d’une chaîne vide («  »), toute extension existante dans la chaîne de chemin d’accès est supprimée.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

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