Функция PathCchFindExtension (pathcch.h)

Статья
02/01/2024

Выполняет поиск по пути, чтобы найти расширение имени файла, например ".exe" или ".ini". Эта функция не выполняет поиск определенного расширения; он ищет наличие любого расширения.

Эта функция отличается от PathFindExtension тем, что принимает пути с префиксами "\", "\?" и "\?\UNC".

Примечание Эту функцию следует использовать вместо PathFindExtension , чтобы предотвратить переполнение буфера.

Синтаксис

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

Параметры

[in] pszPath

Указатель на путь для поиска.

[in] cchPath

Размер буфера, на который указывает pszPath , в символах, включая признак конца null.

[out] ppszExt

Адрес указателя, который при успешном возвращении этой функции указывает на символ "." перед расширением в pszPath. Если расширение не найдено, это указывает на завершающий символ NULL строки.

Возвращаемое значение

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	pathcch.h
Библиотека	Pathcch.lib

Поделиться через