Метод IDebugSymbols3::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 можно использовать для освобождения ресурсов, которые подсистема удерживает для поиска.

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