Метод IDebugSymbols::StartSymbolMatch (dbgeng.h)

Статья
08/07/2023

Метод StartSymbolMatch инициализирует поиск символов, имена которых соответствуют заданному шаблону.

Синтаксис

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

Параметры

[in] Pattern

Указывает шаблон, по которому выполняется поиск. Поиск вернет все символы, имена которых соответствуют этому шаблону. Дополнительные сведения о синтаксисе шаблона см. в разделах Синтаксис символов и Сопоставление символов и Синтаксис подстановочных знаков строк.

[out] Handle

Получает дескриптор, определяющий поиск. Этот дескриптор можно передать в GetNextSymbolMatch и EndSymbolMatch.

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

Этот метод также может возвращать другие значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_NOINTERFACE	Указанный модуль не найден.

Этот метод инициализирует поиск символов. Результаты поиска можно получить с помощью повторных вызовов GetNextSymbolMatch. Когда все нужные результаты будут найдены, используйте EndSymbolMatch , чтобы освободить ресурсы, удерживаемые подсистемой для поиска.

Дополнительные сведения о символах см. в разделе Символы.