IDiaSymbol

Artigo
06/10/2015

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

IDiaSymbol : IUnknown

Métodos em ordem alfabética

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

Dica

Os símbolos retornará dados significativos para apenas alguns de esses métodos, dependendo do tipo de símbolo.Se um método retorna S_OK, então esse método retorna dados significativos.

Método	Descrição
IDiaSymbol::findChildren	Recupera todos os filhos do símbolo.
IDiaSymbol::findChildrenEx	Recupera os filhos do símbolo. Este método é a versão de IDiaSymbol::findChildrenestendido.
IDiaSymbol::findChildrenExByAddr	Recupera os filhos do símbolo que são válidos em um endereço especificado.
IDiaSymbol::findChildrenExByRVA	Recupera os filhos do símbolo que são válidos em um endereço virtual relativo especificado (RVA).
IDiaSymbol::findChildrenExByVA	Recupera os filhos do símbolo que são válidos em um endereço virtual especificado.
IDiaSymbol::findInlineFramesByAddr	Recupera uma enumeração que permite que um cliente executa iterações através dos quadros definidas em um endereço especificado.
IDiaSymbol::findInlineFramesByRVA	Recupera uma enumeração que permite que um cliente executa iterações através dos quadros definidas em um endereço virtual relativo especificado (RVA).
IDiaSymbol::findInlineFramesByVA	Recupera uma enumeração que permite que um cliente executa iterações através dos quadros definidas em um endereço virtual especificado (VA).
IDiaSymbol::findInlineeLines	Recupera uma enumeração que permite que um cliente executa iterações através da linha informações do número das funções que inlined, direta ou indiretamente, em esse símbolo.
IDiaSymbol::findInlineeLinesByAddr	Recupera uma enumeração que permite que um cliente executa iterações através da linha informações do número das funções que inlined, direta ou indiretamente, em esse símbolo dentro do intervalo de endereços especificado.
IDiaSymbol::findInlineeLinesByRVA	Recupera uma enumeração que permite que um cliente executa iterações através da linha informações do número das funções que inlined, direta ou indiretamente, em esse símbolo dentro do endereço virtual relativo especificado (RVA).
IDiaSymbol::findInlineeLinesByVA	Recupera uma enumeração que permite que um cliente executa iterações através da linha informações do número das funções que inlined, direta ou indiretamente, em esse símbolo dentro do endereço virtual especificado (VA).
IDiaSymbol::findSymbolsByRVAForAcceleratorPointerTag	Um determinado valor correspondente da marca, esse método retorna uma enumeração de símbolos que estão contidos em essa função de stub em um endereço virtual relativo especificado.
IDiaSymbol::findSymbolsForAcceleratorPointerTag	Retorna o número de marcas ponteiro de aceleradores na função de stub de AMP de C++.
IDiaSymbol::get_acceleratorPointerTags	Retorna todos os valores da marca do ponteiro de aceleradores que correspondem à função de stub de aceleração de AMP de C++.
IDiaSymbol::get_access	Recupera o modificador de acesso de um membro da classe.
IDiaSymbol::get_addressOffset	Recupera a parte do deslocamento de um local de endereços.
IDiaSymbol::get_addressSection	Recupera a parte da seção de um local de endereços.
IDiaSymbol::get_addressTaken	Recupera um sinalizador que indica se outro símbolo referencia este endereço.
IDiaSymbol::get_age	Recupera o valor da idade de um banco de dados do programa.
IDiaSymbol::get_arrayIndexType	Recupera o identificador do símbolo do tipo de índice de matriz.
IDiaSymbol::get_arrayIndexTypeId	Recupera o identificador de tipo de índice de matriz do símbolo.
IDiaSymbol::get_backEndMajor	Retorna o número de versão principal back-end.
IDiaSymbol::get_backEndMinor	Retorna o número de versão secundária back-end.
IDiaSymbol::get_backEndBuild	Retorna o número de compilação back-end.
IDiaSymbol::get_baseDataOffset	Recupera o deslocamento base de dados.
IDiaSymbol::get_baseDataSlot	Recupera o encaixe de base de dados.
IDiaSymbol::get_baseSymbol	Recupera o símbolo de que o ponteiro é baseado.
IDiaSymbol::get_baseSymbolId	Recupera a identificação do símbolo de que o ponteiro é baseado.
IDiaSymbol::get_baseType	Recupera a marca de tipo de um tipo simples.
IDiaSymbol::get_bitPosition	Retorna a posição dos bits de um local.
IDiaSymbol::get_builtInKind	Recupera um tipo de interna de classificação de HLSL.
IDiaSymbol::get_callingConvention	Retorna um indicador das convenção de chamada de um método.
IDiaSymbol::get_classParent	Recupera uma referência ao pai da classe do símbolo.
IDiaSymbol::get_classParentId	Recupera o identificador da classe pai do símbolo.
IDiaSymbol::get_code	Recupera um sinalizador que indica se o símbolo se refere a um endereço codificado.
IDiaSymbol::get_compilerGenerated	Recupera um sinalizador que indica se o símbolo foi compilador-geradas.
IDiaSymbol::get_compilerName	Recupera o nome do compilador usado para criar Compiland.
IDiaSymbol::get_constructor	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário tem um construtor.
IDiaSymbol::get_container	Recupera o símbolo de contendo o símbolo.
IDiaSymbol::get_constType	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é constante.
IDiaSymbol::get_count	Retorna o número de itens em uma lista ou matriz.
IDiaSymbol::get_countLiveRanges	Retorna o número de intervalos de endereços válidos associados com o símbolo local.
IDiaSymbol::get_customCallingConvention	Recupera um sinalizador que indica se a função usa uma convenção de chamada personalizado.
IDiaSymbol::get_dataBytes	Recupera os bytes de dados de um símbolo de OEM.
IDiaSymbol::get_dataKind	Recupera a classificação variável de um símbolo de dados.
IDiaSymbol::get_editAndContinueEnabled	Recupera o sinalizador que descreve a edição e continuação recursos do programa ou a unidade compilado.
IDiaSymbol::get_farReturn	Recupera um sinalizador que indica se a função usa um distante de retorno.
IDiaSymbol::get_frontEndMajor	Retorna o número de versão principal front-end.
IDiaSymbol::get_frontEndMinor	Retorna o número de versão secundária front-end.
IDiaSymbol::get_frontEndBuild	Retorna o número de compilação front-end.
IDiaSymbol::get_function	Recupera um sinalizador que indica se o símbolo público refere-se a uma função.
IDiaSymbol::get_guid	Recupera GUID do símbolo.
IDiaSymbol::get_hasAlloca	Recupera um sinalizador que indica se a função contém uma chamada para alloca.
IDiaSymbol::get_hasAssignmentOperator	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário tem algum operador de atribuição definido.
IDiaSymbol::get_hasCastOperator	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário tem algum operador cast definido.
IDiaSymbol::get_hasDebugInfo	Recupera um sinalizador que indica se o compiland contém as informações de depuração.
IDiaSymbol::get_hasEH	Recupera um sinalizador que indica se a função tem o manipulador de exceção de energia AC ++-style.
IDiaSymbol::get_hasEHa	Recupera um sinalizador que indica se a função tem um manipulador assíncrono de exceção.
IDiaSymbol::get_hasInlAsm	Recupera um sinalizador que indica se a função tem o assembly embutido.
IDiaSymbol::get_hasLongJump	Recupera um sinalizador que indica se a função contiver um comando de longjmp (parte de manipulação de exceção ctype de estilo).
IDiaSymbol::get_hasManagedCode	Recupera um sinalizador que indica se o módulo contém o código gerenciado.
IDiaSymbol::get_hasNestedTypes	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário tiver aninhado definições de tipo.
IDiaSymbol::get_hasSecurityChecks	Recupera um sinalizador que indica se a função ou o compiland têm as verificações de segurança compilados em (através da opção do compilador de /GS (verificação de segurança do buffer) ).
IDiaSymbol::get_hasSEH	Recupera um sinalizador que indica se a função possui tratamento de exceção estruturada Win32-style.
IDiaSymbol::get_hasSetJump	Recupera um sinalizador que indica se a função contiver um comando de setjmp.
IDiaSymbol::get_indirectVirtualBaseClass	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é uma classe base virtual indireta.
IDiaSymbol::get_InlSpec	Recupera um sinalizador que indica se a função foi marcado com o atributo embutido.
IDiaSymbol::get_interruptReturn	Recupera um sinalizador que indica se a função tem um retorno da declaração de interrupção.
IDiaSymbol::get_intro	Recupera um sinalizador que indica se a função é uma função virtual da classe base.
IDiaSymbol::get_isAcceleratorGroupSharedLocal	Recupera um sinalizador que indica se o símbolo corresponde a uma variável local compartilhado grupo no código compilado para o acelerador de AMP de C++.
IDiaSymbol::get_isAcceleratorPointerTagLiveRange	Recupera um sinalizador que indica se o símbolo corresponde ao símbolo do intervalo de definição para o componente de marca de uma variável do ponteiro no código compilado para o acelerador de AMP de C++. O símbolo do intervalo de definição é o local de uma variável para um período de endereços.
IDiaSymbol::get_isAcceleratorStubFunction	Indica se o símbolo corresponde a um símbolo de nível superior de função para um shader compilado para um acelerador que corresponde a um chamada de parallel_for_each .
IDiaSymbol::get_isAggregated	Recupera um sinalizador que indica se os dados são parte de uma função agregada de muitos símbolos.
IDiaSymbol::get_isCTypes	Recupera um sinalizador que indica se o arquivo do símbolo contém C.
IDiaSymbol::get_isCVTCIL	Recupera um sinalizador que indica se o módulo foi convertido de linguagem intermediária runtime (CIL) para código nativo.
IDiaSymbol::get_isDataAligned	Recupera um sinalizador que indica se os elementos de um tipo de dados definido pelo usuário são alinhados a um limite específico.
IDiaSymbol::get_isHLSLData	Especifica se esse símbolo representa dados de alto nível language (HLSL) de Características.
IDiaSymbol::get_isHotpatchable	Recupera um sinalizador que indica se o módulo foi criado com a opção do compilador de /hotpatch (Criar imagem hotpatchable) .
IDiaSymbol::get_isLTCG	Recupera um sinalizador que indica se o compiland gerenciado foi associado com o LTCG de vinculador.
IDiaSymbol::get_isMatrixRowMajor	Especifica se a matriz é principais da linha.
IDiaSymbol::get_isMSILNetmodule	Recupera um sinalizador que indica se o compiland gerenciado é A. netmodule (que contém somente metadados).
IDiaSymbol::get_isMultipleInheritance	Especifica se os pontos do ponteiro de this a um membro de dados com várias heranças.
IDiaSymbol::get_isNaked	Recupera um sinalizador que indica se a função tem o atributo de naked (C++) .
IDiaSymbol::get_isOptimizedAway	Especifica se a variável é otimizado possam.
IDiaSymbol::get_isPointerBasedOnSymbolValue	Especifica se o ponteiro de this é baseado em um valor do símbolo.
IDiaSymbol::get_isPointerToDataMember	Especifica se esse símbolo é um ponteiro para um membro de dados.
IDiaSymbol::get_isPointerToMemberFunction	Especifica se esse símbolo é um ponteiro para uma função de membro.
IDiaSymbol::get_isReturnValue	Especifica se a variável leva um valor de retorno.
IDiaSymbol::get_isSdl	Especifica se o módulo é compilado com a opção /SDL.
IDiaSymbol::get_isSingleInheritance	Especifica se os pontos do ponteiro de this a um membro de dados com herança única.
IDiaSymbol::get_isSplitted	Recupera um sinalizador que indica se os dados foram divididos em uma função agregada de símbolos separados.
IDiaSymbol::get_isStatic	Recupera um sinalizador que indica se uma função ou uma camada de thunk são estático.
IDiaSymbol::get_isStripped	Recupera um sinalizador que indica se símbolos particulares tenham removidos do arquivo do símbolo.
IDiaSymbol::get_isVirtualInheritance	Especifica se os pontos do ponteiro de this a um membro de dados com herança virtual.
IDiaSymbol::get_language	Recupera o idioma de origem.
IDiaSymbol::get_length	Retorna o número de bytes de memória usados pelo objeto representado por esse símbolo.
IDiaSymbol::get_lexicalParent	Recupera uma referência ao pai lexicalmente do símbolo.
IDiaSymbol::get_lexicalParentId	Recupera o identificador pai lexicalmente do símbolo.
IDiaSymbol::get_libraryName	Recupera o nome de arquivo de biblioteca ou do objeto que o objeto foi carregado.
IDiaSymbol::get_liveRangeLength	Retorna o tamanho do intervalo de endereços em que o símbolo local é válido.
IDiaSymbol::get_liveRangeStartAddressSection	Retorna a parte da seção do intervalo de endereços começando em que o símbolo local é válido.
IDiaSymbol::get_liveRangeStartAddressOffset	Retorna a parte do deslocamento do intervalo de endereços começando em que o símbolo local é válido.
IDiaSymbol::get_liveRangeStartRelativeVirtualAddress	Retorna o início do intervalo de endereços em que o símbolo local é válido.
IDiaSymbol::get_locationType	Recupera o tipo do local de um símbolo de dados.
IDiaSymbol::get_lowerBound	Recupera o limite inferior de uma dimensão da matriz de FORTRAN.
IDiaSymbol::get_lowerBoundId	Recupera o identificador do símbolo do limite inferior de uma dimensão da matriz de FORTRAN.
IDiaSymbol::get_machineType	Recupera o tipo CPU de destino.
IDiaSymbol::get_managed	Recupera um sinalizador indicando se que o símbolo refere-se ao código gerenciado.
IDiaSymbol::get_memorySpaceKind	Recupera o tipo de espaço de memória.
IDiaSymbol::get_msil	Recupera um sinalizador que indica se o símbolo refere-se ao código Microsoft intermediate language (MSIL).
IDiaSymbol::get_name	Recupera o nome do símbolo.
IDiaSymbol::get_nested	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário está aninhado.
IDiaSymbol::get_noInline	Recupera um sinalizador que indica se a função é marcada com o atributo de noinline .
IDiaSymbol::get_noReturn	Recupera um sinalizador que indica se a função foi declarada com o atributo de noreturn .
IDiaSymbol::get_noStackOrdering	Recupera um sinalizador que indica se nenhum pedido de pilha pode ser feito como parte de verificação de buffer de pilha.
IDiaSymbol::get_notReached	Recupera um sinalizador que indica se a função ou o rótulo são alcançadas nunca.
IDiaSymbol::get_numberOfAcceleratorPointerTags	Retorna o número de marcas ponteiro de aceleradores na função de stub de AMP de C++.
IDiaSymbol::get_numberOfModifiers	Retorna o número de modificadores que são aplicados ao tipo original.
IDiaSymbol::get_numberOfRegisterIndices	Retorna o número de índices de registro.
IDiaSymbol::get_numberOfRows	Retorna o número de linhas na matriz.
IDiaSymbol::get_numberOfColumns	Retorna o número de colunas na matriz.
IDiaSymbol::get_objectFileName	Recupera o nome de arquivo do objeto.
IDiaSymbol::get_objectPointerType	Recupera o tipo ponteiro de objeto para um método da classe.
IDiaSymbol::get_oemId	Recupera o valor de oemId do símbolo.
IDiaSymbol::get_oemSymbolId	Recupera o valor de oemSymbolId do símbolo.
IDiaSymbol::get_offset	Recuperar o deslocamento do local do símbolo.
IDiaSymbol::get_optimizedCodeDebugInfo	Recupera um sinalizador que indica se a função ou o rótulo contêm o código bem como informações otimizados de depuração.
IDiaSymbol::get_overloadedOperator	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário tenha sobrecarregado operadores.
IDiaSymbol::get_packed	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é empacotado.
IDiaSymbol::get_platform	Recupera o tipo de plataforma para que o programa ou o compiland foram compilados.
IDiaSymbol::get_pure	Recupera um sinalizador que indicando se a função é puro virtual.
IDiaSymbol::get_rank	Recupera o grau de um array multidimensional de FORTRAN.
IDiaSymbol::get_reference	Recupera um sinalizador que indica se um tipo ponteiro é uma referência.
IDiaSymbol::get_registerId	Recupera o designador de registro do local.
IDiaSymbol::get_registerType	Recupera o tipo do registro.
IDiaSymbol::get_relativeVirtualAddress	Recupera o endereço virtual relativo (RVA) local.
IDiaSymbol::get_restrictedType	Especifica se o ponteiro de this está embandeirado como restrito.
IDiaSymbol::get_samplerSlot	Recupera o encaixe de demonstrador.
IDiaSymbol::get_scoped	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário será exibido em um escopo lexicalmente nonglobal.
IDiaSymbol::get_signature	Recupera o valor da assinatura do símbolo.
IDiaSymbol::get_sizeInUdt	Retorna o tamanho de um membro de um tipo definido pelo usuário.
IDiaSymbol::get_slot	Retorna o número de encaixe de local.
IDiaSymbol::get_sourceFileName	Recupera o nome do arquivo de origem.
IDiaSymbol::getSrcLineOnTypeDefn	Recupera o arquivo fonte e o número da linha que indica onde um tipo definido pelo usuário especificado está definido.
IDiaSymbol::get_stride	Recupera o passo de matriz ou matriz strided.
IDiaSymbol::get_subType	Recupera o tipo sub.
IDiaSymbol::get_subTypeId	Recupera a identificação de tipo sub
IDiaSymbol::get_symbolsFileName	Recupera o nome do arquivo que os símbolos foram carregados.
IDiaSymbol::get_symIndexId	Recupera o identificador exclusivo do símbolo.
IDiaSymbol::get_symTag	Recupera o classificador do tipo do símbolo.
IDiaSymbol::get_targetOffset	Recupera a seção de deslocamento de um destino de thunk.
IDiaSymbol::get_targetRelativeVirtualAddress	Recupera o endereço virtual relativo (RVA) de um destino de thunk.
IDiaSymbol::get_targetSection	Recupera a seção de um endereço de destino de thunk.
IDiaSymbol::get_targetVirtualAddress	Recupera o endereço virtual (VA) de um destino de thunk.
IDiaSymbol::get_textureSlot	Recupera o encaixe de textura.
IDiaSymbol::get_thisAdjust	Recupera o ajustador lógico de this para o método.
IDiaSymbol::get_thunkOrdinal	Recupera o tipo de thunk de uma função.
IDiaSymbol::get_timeStamp	Recupera o carimbo de data/hora do arquivo executável subjacente.
IDiaSymbol::get_token	Recupera o token de metadados de uma função ou de uma variável gerenciado.
IDiaSymbol::get_type	Recupera uma referência para a assinatura de função.
IDiaSymbol::get_typeId	Recupera o identificador de tipo do símbolo.
IDiaSymbol::get_types	Recupera uma matriz de compilador valores específicos de tipo para esse símbolo.
IDiaSymbol::get_typeIds	Recupera uma matriz de valores específicos de compilador identificador de tipo para esse símbolo.
IDiaSymbol::get_uavSlot	Recupera o encaixe de uav.
IDiaSymbol::get_udtKind	Recupera a variedade de um tipo definido pelo usuário (UDT).
IDiaSymbol::get_unalignedType	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é unaligned.
IDiaSymbol::get_undecoratedName	Recupera o nome undecorated para a C++ decorada, ou ligação, o nome.
IDiaSymbol::get_undecoratedNameEx	A extensão do método de get_undecoratedName que retorna o nome undecorated com base no valor de um campo de extensão.
IDiaSymbol::get_unmodifiedTypeId	Recupera a identificação do tipo () não modificadas original.
IDiaSymbol::get_upperBound	Recupera o limite superior de uma dimensão da matriz de FORTRAN.
IDiaSymbol::get_upperBoundId	Recupera o identificador do símbolo o limite superior de uma dimensão da matriz de FORTRAN.
IDiaSymbol::get_value	Recupera o valor de uma constante.
IDiaSymbol::get_virtual	Recupera um sinalizador que indica se a função é virtual.
IDiaSymbol::get_virtualAddress	Recupera o endereço virtual (VA) local.
IDiaSymbol::get_virtualBaseClass	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é uma classe base virtual.
IDiaSymbol::get_virtualBaseDispIndex	Retorna o índice à tabela de base de deslocamento virtual.
IDiaSymbol::get_virtualBaseOffset	Recupera o deslocamento na tabela de funções virtuais de uma função virtual.
IDiaSymbol::get_virtualBasePointerOffset	Recuperar o deslocamento do ponteiro base virtual.
IDiaSymbol::get_virtualBaseTableType	Recupera o tipo de um ponteiro de base virtual da tabela.
IDiaSymbol::get_virtualTableShape	Recupera a interface do símbolo do tipo de tabela virtual para um tipo definido pelo usuário.
IDiaSymbol::get_virtualTableShapeId	Recupera o identificador virtual da forma da tabela do símbolo.
IDiaSymbol::get_volatileType	Recupera um sinalizador que indica se o tipo de dados definido pelo usuário é temporário.

Comentários

Observações para chamadores

Obtenha essa interface chamando um dos seguintes métodos:

Exemplo

Este exemplo mostra como exibir as variáveis locais para uma função em um endereço virtual relativo dado. Também mostra como símbolos de diferentes tipos são relacionados entre si.

Dica

CDiaBSTR é uma classe que quebra BSTR e automaticamente trata que liberam a cadeia de caracteres quando a instanciação sai do escopo.

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