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

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

Синтаксис

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

Параметры

[in] Pattern

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

[out] Handle

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

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

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

Замечания

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

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

Требования

См. также

EndSymbolMatch

GetNextSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3