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


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

Сравнивает указанную строку с указанным выражением с подстановочными знаками.

Синтаксис

BOOL IMAGEAPI SymMatchStringW(
  [in] PCWSTR string,
  [in] PCWSTR expression,
  [in] BOOL   fCase
);

Параметры

[in] string

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

[in] expression

Выражение с подстановочными знаками, сравниваемое со строковым параметром. Выражение с подстановочными знаками поддерживает включение * и ? символов. * соответствует любой строке и ? соответствует любому отдельному символу.

[in] fCase

Переменная, указывающая, следует ли учитывать регистр в сравнении.

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

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

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

Комментарии

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

Примечание

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

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 6.2 или более поздней версии

См. также раздел

Функции DbgHelp