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

Статья
11/20/2024

Сравнивает два пути, чтобы определить, совместно ли они используют общий префикс. Префикс является одним из следующих типов: "C:\", ".", "..", ". \".

Синтаксис

int PathCommonPrefixW(
  [in]            LPCWSTR pszFile1,
  [in]            LPCWSTR pszFile2,
  [out, optional] LPWSTR  achPath
);

Параметры

[in] pszFile1

Тип: LPCTSTR

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

[in] pszFile2

Тип: LPCTSTR

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

[out, optional] achPath

Тип: LPTSTR

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

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

Тип: int

Возвращает количество общих символов префикса в пути. Если указатель на выходной буфер не null, эти символы копируются в выходной буфер.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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