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

  • Статья

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

Синтаксис

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

Параметры

[in] pszPath

Тип: LPCTSTR

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

[in] apszSuffix

Тип: const LPCTSTR*

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

[in] iArraySize

Тип: int

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

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

Тип: LPCTSTR

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

Комментарии

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

Примечание

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

Требования

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