Функция SymMatchFileName (dbghelp.h)
Сравнивает строку с именем файла и путем.
Синтаксис
BOOL IMAGEAPI SymMatchFileName(
[in] PCSTR FileName,
[in] PCSTR Match,
[out, optional] PSTR *FileNameStop,
[out, optional] PSTR *MatchStop
);
Параметры
[in] FileName
Имя файла, сравниваемое с параметром Match .
[in] Match
Строка, сравниваемая с параметром FileName .
[out, optional] FileNameStop
Указатель на буфер строки, получающий указатель на расположение в FileName , где сопоставление остановлено. Для полного совпадения это значение может быть одним символом перед FileName. Это значение также может иметь значение NULL.
[out, optional] MatchStop
Указатель на буфер строки, получающий указатель на расположение в поле Совпадение , где сопоставление остановлено. Для полного совпадения это значение может быть одним символом перед совпадением. Это значение может иметь значение NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Так как строка соответствия может быть суффиксом полного имени файла, эту функцию можно использовать для сопоставления простого имени файла с полным именем файла.
Сопоставление начинается с конца обеих строк и продолжается назад. Сопоставление не учитывает регистр и приравнивает обратную косую черту (\) к косой черте (/).
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 5.1 или более поздней версии |