Fonction PathCchRenameExtension (pathcch.h)

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

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