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

Статья
02/23/2024

Метод 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

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Размер буфера был слишком мал для имени символа или буфер был равен NULL.
E_NOINTERFACE	Больше не найдены символы, соответствующие шаблону.

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

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