IDiaEnumSymbolsByAddr2

Статья
11/21/2024

Перечисляется по адресу различных символов, содержащихся в источнике данных.

Синтаксис

IDiaEnumSymbolsByAddr2 : IDiaEnumSymbolsByAdd

Методы в порядке таблицы Vtable

В следующей таблице показаны методы IDiaEnumSymbolsByAddr2.

Метод	Description
`IDiaEnumSymbolsByAddr2::symbolByAddrEx`	Размещает перечислитель путем выполнения подстановки по разделу и смещениям.
`IDiaEnumSymbolsByAddr2::symbolByRVAEx`	Размещает перечислитель путем выполнения подстановки по относительному виртуальному адресу (RVA).
`IDiaEnumSymbolsByAddr2::symbolByVAEx`	Размещает перечислитель путем выполнения подстановки по виртуальному адресу (VA).
`IDiaEnumSymbolsByAddr2::NextEx`	Извлекает следующие символы по адресу. Обновляет положение перечислителя по количеству элементов, извлекаемых.
`IDiaEnumSymbolsByAddr2::PrevEx`	Извлекает предыдущие символы по адресу. Обновляет положение перечислителя по количеству элементов, извлекаемых.

Замечания

Этот интерфейс предоставляет символы, сгруппированные по адресу. Для работы с символами, сгруппированных по типу, например SymTagUDT (определяемый пользователем тип) или SymTagBaseClassиспользуйте IDiaEnumSymbols интерфейс.

Заметки для вызывающих абонентов

Получите этот интерфейс путем IDiaSession::getSymbolsByAddr вызова метода, а затем вызова IUnknown::QueryInterface с заданным параметром riid IID_IDiaEnumSymbolsByAddr2.

Пример

Эта функция отображает имя и адрес всех символов, упорядоченных относительным виртуальным адресом.

void ShowSymbolsByAddress(IDiaSession *pSession)
{
    CComPtr<IDiaEnumSymbolsByAddr> pEnumByAddr;
    if ( FAILED( psession->getSymbolsByAddr( &pEnumByAddr ) ) )
    {
        Fatal( "getSymbolsByAddr" );
    }
    CComPtr<IDiaEnumSymbolsByAddr2> pEnumByAddr2;
    if ( FAILED( pEnumByAddr->QueryInterface( IID_IDiaEnumSymbolsByAddr2, &pEnumByAddr2 ) ) )
    {
        Fatal( "getSymbolsByAddr" );
    }
    CComPtr<IDiaSymbol> pSym;
    if ( FAILED( pEnumByAddr2->symbolByAddrEx( FALSE, 1, 0, &pSym ) ) )
    {
        Fatal( "symbolByAddr" );
    }
    DWORD rvaLast = 0;
    if ( pSym->get_relativeVirtualAddress( &rvaLast ) == S_OK )
    {
        pSym = 0;
        if ( FAILED( pEnumByAddr2->symbolByRVAEx( FALSE, rvaLast, &pSym ) ) )
        {
            Fatal( "symbolByAddr" );
        }
        printf( "Symbols in order\n" );
        do
        {
            CDiaBSTR name;
            if ( pSym->get_name( &name ) != S_OK )
            {
                printf( "\t0x%08X (%ws) <no name>\n", rvaLast );
            }
            else
            {
                printf( "\t0x%08X %ws\n", rvaLast, name );
            }
            pSym = 0;
            celt = 0;
            if ( FAILED( hr = pEnumByAddr2->NextEx( FALSE, 1, &pSym, &celt ) ) )
            {
                break;
            }
        } while ( celt == 1 );
    }
}

Требования

Заголовок: Dia2.h

Библиотека: diaguids.lib

DLL: msdia140.dll

Поделиться через