IDiaSymbol

Descreve as propriedades de uma instância de símbolo.

Sintaxe

IDiaSymbol : IUnknown

Métodos em ordem alfabética

A tabela a seguir mostra os métodos de IDiaSymbol.

Observações

Anotações para chamadores

Obtenha essa interface chamando um dos seguintes métodos:

• IDiaEnumSymbols::Item

• IDiaEnumSymbols::Next

• IDiaEnumSymbolsByAddr::Next

• IDiaEnumSymbolsByAddr::P rev

• IDiaEnumSymbolsByAddr::symbolByAddr

• IDiaEnumSymbolsByAddr::symbolByRVA

• IDiaEnumSymbolsByAddr::symbolByVA

• IDiaSession::findSymbolByAddr

• IDiaSession::findSymbolByRVA

• IDiaSession::findSymbolByRVAEx

• IDiaSession::findSymbolByVA

• IDiaSession::findSymbolByVAEx

• IDiaSession::findSymbolByToken

• IDiaSession::symbolById

• IDiaStackWalkHelper::symbolForVA

• IDiaSymbol::get_types

Exemplo

Este exemplo mostra como exibir as variáveis locais para uma função em um determinado endereço virtual relativo. Ele também mostra como símbolos de diferentes tipos estão relacionados uns aos outros.

void DumpLocalVars( DWORD rva, IDiaSession *pSession )
{
    CComPtr< IDiaSymbol > pBlock;
    if ( FAILED( psession->findSymbolByRVA( rva, SymTagBlock, &pBlock ) ) )
    {
        Fatal( "Failed to find symbols by RVA" );
    }
    CComPtr< IDiaSymbol > pscope;
    for ( ; pBlock != NULL; )
    {
        CComPtr< IDiaEnumSymbols > pEnum;
        // local data search
        if ( FAILED( pBlock->findChildren( SymTagNull, NULL, nsNone, &pEnum ) ) )
        {
            Fatal( "Local scope findChildren failed" );
        }
        CComPtr< IDiaSymbol > pSymbol;
        DWORD tag;
        DWORD celt;
        while ( pEnum != NULL &&
                SUCCEEDED( pEnum->Next( 1, &pSymbol, &celt ) ) &&
                celt == 1)
        {
            pSymbol->get_symTag( &tag );
            if ( tag == SymTagData )
            {
                CDiaBSTR name;
                DWORD    kind;
                pSymbol->get_name( &name );
                pSymbol->get_dataKind( &kind );
                if ( name != NULL )
                    wprintf_s( L"\t%s (%s)\n", name, szDataKinds[ kind ] );
            }
            else if ( tag == SymTagAnnotation )
            {
                CComPtr< IDiaEnumSymbols > pValues;
                // local data search
                wprintf_s( L"\tAnnotation:\n" );
                if ( FAILED( pSymbol->findChildren( SymTagNull, NULL, nsNone, &pValues ) ) )
                    Fatal( "Annotation findChildren failed" );
                pSymbol = NULL;
                while ( pValues != NULL &&
                        SUCCEEDED( pValues->Next( 1, &pSymbol, &celt ) ) &&
                        celt == 1 )
                {
                    CComVariant value;
                    if ( pSymbol->get_value( &value ) != S_OK )
                        Fatal( "No value for annotation data." );
                    wprintf_s( L"\t\t%ws\n", value.bstrVal );
                    pSymbol = NULL;
                }
            }
            pSymbol = NULL;
        }
        pBlock->get_symTag( &tag );
        if ( tag == SymTagFunction )    // stop when at function scope
            break;
        // move to lexical parent
        CComPtr< IDiaSymbol > pParent;
        if ( SUCCEEDED( pBlock->get_lexicalParent( &pParent ) )
            && pParent != NULL ) {
            pBlock = pParent;
        }
        else
        {
            Fatal( "Finding lexical parent failed." );
        }
    };
}

Requisitos

Header: Dia2.h

Biblioteca: diaguids.lib

DLL: msdia140.dll

Consulte também

• Interfaces (SDK de Acesso à Interface de Depuração)
• IDiaEnumSymbolsByAddr
• IDiaEnumSymbols
• IDiaSession
• Hierarquia de classe de tipos de símbolo
• símbolos e marcas de símbolo
• compiland