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


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

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

Эта функция отличается от 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