IDiaSymbol

描述符號執行個體的屬性。

IDiaSymbol : IUnknown

方法會按照字母順序

下表顯示 IDiaSymbol方法。

注意事項
符號依符號的型別會傳回有意義的資料只會對某些方法，。如果方法傳回 S_OK，則該方法會傳回有意義的資料。

備註

呼叫端的注意事項。

透過呼叫下列其中一個方法來取得這個介面:

• IDiaEnumSymbols::Item

• IDiaEnumSymbols::Next

• IDiaEnumSymbolsByAddr::Next

• IDiaEnumSymbolsByAddr::Prev

• 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

範例

這個範例示範如何顯示函式的區域變數是在指定的相對虛擬位址。 它也會顯示不同類型的符號相互間的關聯性。

注意事項
CDiaBSTR 是包裝釋放字串的 BSTR 並自動控制代碼的類別，以執行個體化超出範圍時。

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

需求

Header: Dia2.h

程式庫:diaguids.lib

DLL:msdia80.dll

請參閱

參考

IDiaEnumSymbolsByAddr

IDiaEnumSymbols

IDiaSession

符號型別的類別階層架構

Compiland

其他資源

介面 (偵錯介面存取 SDK)

符號和符號標記