Функция SymMatchFileNameW (dbghelp.h)

Статья
11/20/2024

Сравнивает строку с именем файла и путем.

Синтаксис

BOOL IMAGEAPI SymMatchFileNameW(
  [in]            PCWSTR FileName,
  [in]            PCWSTR Match,
  [out, optional] PWSTR  *FileNameStop,
  [out, optional] PWSTR  *MatchStop
);

Параметры

[in] FileName

Имя файла, сравниваемое с параметром Match.

[in] Match

Строка для сравнения с параметром fileName .

[out, optional] FileNameStop

Указатель на строковый буфер, который получает указатель на расположение в FileName, где остановлено сопоставление. Для полного совпадения это значение может быть одним символом перед Имя_файла. Это значение также может быть null.

[out, optional] MatchStop

Указатель на строковый буфер, который получает указатель на расположение в Match, где остановлено сопоставление. Для полного совпадения это значение может быть одним символом перед Match. Это значение может быть NULL.

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

Если функция выполнена успешно, возвращаемое значение TRUE.

Если функция завершается ошибкой, возвращаемое значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Так как строка сопоставления может быть суффиксом полного имени файла, эта функция может использоваться для сопоставления обычного имени файла с полным именем файла.

Сопоставление начинается с конца обеих строк и продолжается назад. Сопоставление не учитывает регистр и приравнивает обратную косую черту (\) с косой чертой вперед (/).

Все функции DbgHelp, такие как этот, являются одним потоком. Таким образом, вызовы из нескольких потоков в эту функцию, скорее всего, приведет к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все одновременные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию этой функции Юникода, определите DBGHELP_TRANSLATE_TCHAR.

Заметка

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 5.1 или более поздней версии

См. также

функций DbgHelp

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