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

Метод GetNextSymbolMatch возвращает следующий символ, найденный в поиске символов.

Синтаксис

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Параметры

[in] Handle

Задает дескриптор, возвращаемый StartSymbolMatch при инициализации поиска.

[out, optional] Buffer

Получает имя символа. Если буферnull, то при следующем вызове одного из этих методов (с тем же дескриптором) будет возвращен тот же символ; это можно использовать для определения размера символа.

[in] BufferSize

Задает размер в символах буфера. Этот размер включает пробел для завершающего символа \0.

[out, optional] MatchSize

Получает размер в символах имени символа. Этот размер включает пробел для завершающего символа \0. Если MatchSizeNULL, эти сведения не возвращаются.

[out, optional] Offset

Получает расположение в виртуальном адресном пространстве целевого объекта символа. Если смещениеNULL, эти сведения не возвращаются.

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

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

Замечания

Сначала поиск должен быть инициализирован StartSymbolMatch. После обнаружения всех нужных символов EndSymbolMatch можно использовать для освобождения ресурсов, которые подсистема содержит для поиска.

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

Требования

См. также

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch