IDiaEnumSymbolsByAddr

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

语法

IDiaEnumSymbolsByAddr : IUnknown

Vtable 顺序中的方法

下表显示了 IDiaEnumSymbolsByAddr 方法。

方法 说明
IDiaEnumSymbolsByAddr::symbolByAddr 通过按分区和偏移量执行查找来定位枚举器。
IDiaEnumSymbolsByAddr::symbolByRVA 通过按相对虚拟地址 (RVA) 执行查找来定位枚举器。
IDiaEnumSymbolsByAddr::symbolByVA 通过按虚拟地址 (VA) 执行查找来定位枚举器。
IDiaEnumSymbolsByAddr::Next 按地址顺序检索后面的符号。 按提取的元素数更新枚举器位置。
IDiaEnumSymbolsByAddr::Prev 按地址顺序检索以前的符号。 按提取的元素数更新枚举器位置。
IDiaEnumSymbolsByAddr::Clone 创建对象的副本。

备注

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

对调用者的说明

通过调用 IDiaSession::getSymbolsByAddr 方法获取此接口。

示例

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

void ShowSymbolsByAddress(IDiaSession *pSession)
{
    CComPtr<IDiaEnumSymbolsByAddr> pEnumByAddr;
    if ( FAILED( psession->getSymbolsByAddr( &pEnumByAddr ) ) )
    {
        Fatal( "getSymbolsByAddr" );
    }
    CComPtr<IDiaSymbol> pSym;
    if ( FAILED( pEnumByAddr->symbolByAddr( 1, 0, &pSym ) ) )
    {
        Fatal( "symbolByAddr" );
    }
    DWORD rvaLast = 0;
    if ( pSym->get_relativeVirtualAddress( &rvaLast ) == S_OK )
    {
        pSym = 0;
        if ( FAILED( pEnumByAddr->symbolByRVA( 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 = pEnumByAddr->Next( 1, &pSym, &celt ) ) )
            {
                break;
            }
        } while ( celt == 1 );
    }
}

要求

标头:Dia2.h

库:diaguids.lib

DLL:msdia80.dll

另请参阅