Функция PathCompactPathExW (shlwapi.h)

Усекает путь в пределах определенного количества символов, заменяя компоненты пути многоточием.

Синтаксис

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR pszSrc,
  [in]  UINT    cchMax,
  [in]  DWORD   dwFlags
);

Параметры

[out] pszOut

Тип: LPTSTR

Адрес измененной строки.

[in] pszSrc

Тип: LPCTSTR

Указатель на строку длиной, заканчивающуюся значением NULL, MAX_PATH, содержащую путь для изменения.

[in] cchMax

Тип: UINT

Максимальное число символов, содержащихся в новой строке, включая завершающий символ NULL. Например, если cchMax = 8, результирующая строка может содержать не более 7 символов плюс завершающий символ NULL.

[in] dwFlags

Тип: DWORD

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

Тип: BOOL

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Комментарии

Разделитель "/" будет использоваться вместо "\", если он использовался в исходной строке. Если pszSrc указывает на слишком длинное имя файла, а не путь, имя файла будет усечено до символов cchMax , включая многоточие и завершающий символ NULL . Например, если входное имя файла — "My Filename", а cchMax — 10, PathCompactPathEx вернет "My Fil...".

Примечание

Заголовок shlwapi.h определяет PathCompactPathEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)