Símbolos e marcas de símbolos

As informações de depuração sobre um programa compilado são armazenadas no arquivo de banco de dados do programa (.pdb) como símbolos acessíveis usando as APIs do SDK do DIA (Acesso à Interface de Depuração). Todos os símbolos têm uma propriedade IDiaSymbol::get_symTag e IDiaSymbol::get_symIndexId. A propriedade symTag indica o tipo de símbolo conforme definido pela Enumeração SymTagEnum. A propriedade symIndexId é um valor DWORD que contém o identificador exclusivo para cada instância de um símbolo.

Os símbolos também têm propriedades que podem especificar informações adicionais sobre o símbolo, bem como referências a outros símbolos, geralmente um IDiaSymbol::get_lexicalParent ou IDiaSymbol::get_classParent. Quando você consulta uma propriedade que contém uma referência, essa referência é retornada como um objeto IDiaSymbol. Essas propriedades são sempre emparelhadas com outra propriedade com o mesmo nome, mas com o sufixo "Id", por exemplo, IDiaSymbol::get_lexicalParentId e IDiaSymbol::get_classParentId. As tabelas em Locais de Símbolos, Hierarquia Lexical de Tipos de Símbolo e Hierarquia de Classe de Tipos de Símbolo descrevem as propriedades de cada um dos diferentes tipos de símbolos. Essas propriedades podem ter informações relevantes sobre símbolos ou referências a outros símbolos. Como as propriedades *Id são simplesmente identificadores ordinais numéricos de suas propriedades relacionadas, elas são omitidas de discussões adicionais. Elas são referenciadas somente quando necessário para esclarecimento de parâmetros.

Ao tentar acessar a propriedade, se nenhum erro ocorrer e a propriedade de símbolo tiver sido atribuída a um valor, o método "get" da propriedade retornará S_OK. Um valor retornado de S_FALSE indica que a propriedade não é válida para o símbolo atual.

Nesta seção

Locais de símbolos

Descreve os diferentes tipos de locais que um símbolo pode ter.

Hierarquia lexical de tipos de símbolo

Descreve os tipos de símbolo que formam hierarquias léxicas, como arquivos, módulos e funções.

Hierarquia de classes de tipos de símbolo

Descreve os tipos de símbolo que correspondem a diferentes elementos de linguagem, como classes, matrizes e tipos de retorno de função.

Confira também

• SDK de Acesso à Interface de Depuração