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

Статья
03/01/2024

Удаляет расширение имени файла из пути, если оно имеется.

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

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

Синтаксис

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

Параметры

[in, out] pszPath

Указатель на строку пути. При успешном возврате этой функции строка содержит путь с удаленным расширением. Если расширение не найдено, строка не изменяется.

[in] cchPath

Размер буфера, на который указывает pszPath, в символах.

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

Эта функция возвращает S_OK , если функция была успешной, S_FALSE , если расширение не найдено, или код ошибки в противном случае.

Требования

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

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