IDiaEnumSymbolsByAddr2

按地址枚举数据源中包含的各种符号。

语法

IDiaEnumSymbolsByAddr2 : IDiaEnumSymbolsByAdd

Vtable 顺序中的方法

下表显示了 IDiaEnumSymbolsByAddr2 方法。

方法 说明
IDiaEnumSymbolsByAddr2::symbolByAddrEx 通过按分区和偏移量执行查找来定位枚举器。
IDiaEnumSymbolsByAddr2::symbolByRVAEx 通过按相对虚拟地址 (RVA) 执行查找来定位枚举器。
IDiaEnumSymbolsByAddr2::symbolByVAEx 通过按虚拟地址 (VA) 执行查找来定位枚举器。
IDiaEnumSymbolsByAddr2::NextEx 按地址顺序检索后面的符号。 按提取的元素数更新枚举器位置。
IDiaEnumSymbolsByAddr2::PrevEx 按地址顺序检索以前的符号。 按提取的元素数更新枚举器位置。

注解

此接口提供按地址分组的符号。 若要使用按类型分组的符号,例如SymTagUDT(用户定义的类型),或使用SymTagBaseClassIDiaEnumSymbols接口。

呼叫者说明

通过调用IDiaSession::getSymbolsByAddr方法,然后使用参数设置为 <a0/> 来IUnknown::QueryInterfaceriid获取此接口。

示例

此函数显示按相对虚拟地址排序的所有符号的名称和地址。

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

另请参阅