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

Статья
11/20/2024

Соответствует имени файла из пути к одному или нескольким шаблонам имен файлов.

Синтаксис

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR pszSpec,
  [in] DWORD  dwFlags
);

Параметры

[in] pszFile

Тип: LPCTSTR

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

[in] pszSpec

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая содержит шаблон имени файла, для которого выполняется поиск. Это может быть точное имя или содержать подстановочные знаки. Если указан точный шаблон, задайте флаг PMSF_NORMAL в dwFlags. Если задано несколько шаблонов, разделите их точкой с запятой и задайте флаг PMSF_MULTIPLE.

[in] dwFlags

Тип: DWORD

Изменяет условие поиска. Ниже приведены допустимые флаги.

PMSF_NORMAL (0x00000000)

Параметр pszSpec указывает на один шаблон имени файла, который необходимо сопоставить.

PMSF_MULTIPLE (0x00000001)

Параметр pszS pec указывает на список шаблонов имен файлов, разделенных точкой с запятой.

PMSF_DONT_STRIP_SPACES (0x00010000)

Если используется PMSF_NORMAL, не игнорируйте ведущие пробелы в строке, на которую указывает pszSpec. Если используется PMSF_MULTIPLE, не игнорируйте ведущие пробелы в каждом типе файла, содержащемся в строке, на которую указывает pszSpec. Этот флаг можно объединить с PMSF_NORMAL и PMSF_MULTIPLE.

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

Тип: HRESULT

Возвращает одно из следующих значений.

Возвращаемый код	Описание
S_OK	Шаблон имени файла, указанный в pszSpec совпадает с именем файла, найденным в строке, на которую указывает pszFile.
S_FALSE	Шаблон имени файла, указанный в pszSpec, не совпадал с именем файла, найденным в строке, на которую указывает pszFile.

Замечания

Заметка

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

Требования

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

См. также

PathMatchSpec

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