IDiaSymbol

Descreve as propriedades de uma ocorrê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

Notas para chamadores

Obtenha essa interface chamando um dos seguintes métodos:

• IDiaEnumSymbols::Item

• IDiaEnumSymbols::Seguinte

• IDiaEnumSymbolsByAddr::Seguinte

• 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 de uma função em um determinado endereço virtual relativo. Também mostra como símbolos de diferentes tipos estão relacionados entre si.

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." );
        }
    };
}

Requerimentos

Header: Dia2.h

Biblioteca: diaguids.lib

DLL: msdia140.dll

Ver também

• Interfaces (Debug Interface Access SDK)
• IDiaEnumSymbolsByAddr
• IDiaEnumSymbols
• IDiaSession
• Hierarquia de classes de tipos de símbolos
• Símbolos e Tags de Símbolos
• Compilar