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

符号类型的类层次结构

编译单位

其他资源

接口（调试接口访问 SDK）

符号和符号标记