Fonction PathCchRemoveExtension (pathcch.h)

Article
03/01/2024

Supprime l’extension de nom de fichier d’un chemin d’accès, le cas échéant.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Paramètres

[in, out] pszPath

Pointeur vers la chaîne de chemin d’accès. Lorsque cette fonction retourne correctement, la chaîne contient le chemin d’accès avec n’importe quelle extension supprimée. Si aucune extension n’a été trouvée, la chaîne est inchangée.

[in] cchPath

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

Valeur retournée

Cette fonction retourne S_OK si la fonction a réussi, S_FALSE si aucune extension n’a été trouvée ou un code d’erreur dans le cas contraire.

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

Partager via