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

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

  • Статья

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

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

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

Синтаксис

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

Параметры

[in, out] pszPath

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

[in] cchPath

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

[in] pszExt

Указатель на новую строку расширения. Символ "." является необязательным. В случае пустой строки ("") удаляется любое существующее расширение в строке пути.

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

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

Требования

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