Partager via

PathCchFindExtension, fonction (pathcch.h)

  • Article

Recherche un chemin d’accès pour trouver son extension de nom de fichier, par exemple « .exe » ou « .ini ». Cette fonction ne recherche pas une extension spécifique ; il recherche la présence d’une extension.

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

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

Syntaxe

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Paramètres

[in] pszPath

Pointeur vers le chemin d’accès à rechercher.

[in] cchPath

Taille de la mémoire tampon pointée par pszPath en caractères, y compris la marque de fin Null.

[out] ppszExt

Adresse d’un pointeur qui, lorsque cette fonction retourne correctement, pointe vers le caractère « . » qui précède l’extension dans pszPath. Si aucune extension n’est trouvée, elle pointe vers le caractère null de fin de la chaîne.

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