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

Статья
11/20/2024

Определяет, имеет ли заданное имя файла один из списков суффиксов.

Синтаксис

LPCWSTR PathFindSuffixArrayW(
  [in] LPCWSTR       pszPath,
  [in] const LPCWSTR *apszSuffix,
  [in] int           iArraySize
);

Параметры

[in] pszPath

Тип: LPCTSTR

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

[in] apszSuffix

Тип: const LPCTSTR*

Массив строковых указателей iArraySize. Каждая строка, на которая указывает значение NULL, завершается и содержит один суффикс. Строки могут иметь переменную длину.

[in] iArraySize

Тип: int

Количество элементов в массиве, на которое указывает apszSuffix.

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

Тип: LPCTSTR

Возвращает указатель на строку с соответствующим суффиксом в случае успешного выполнения или NULL, если pszPath не заканчивается одним из указанных суффиксов.

Замечания

Эта функция использует сравнение с учетом регистра. Суффикс должен совпадать точно.

Заметка

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

Требования

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

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