Partilhar via

IDiaSession::symbolById

  • Artigo

Recupera um símbolo por meio de seu identificador exclusivo.

Sintaxe

HRESULT symbolById (
    DWORD        id,
    IDiaSymbol** ppSymbol
);

Parâmetros

id

[in] Identificador exclusivo.

ppSymbol

[out] Retorna um objeto IDiaSymbol que representa o símbolo recuperado.

Valor Retornado

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Comentários

O identificador especificado é um valor exclusivo usado internamente pelo DIA SDK para tornar todos os símbolos exclusivos.

Esse método pode ser usado, por exemplo, para recuperar o símbolo que representa o tipo de outro símbolo (consulte o exemplo).

Exemplo

Esse exemplo recupera um IDiaSymbol que representa o tipo de outro símbolo. Esse exemplo mostra como usar o método symbolById na sessão. Uma abordagem mais simples é chamar o método IDiaSymbol::get_type para recuperar o símbolo de tipo diretamente.

IDiaSymbol *GetSymbolType(IDiaSymbol *pSymbol, IDiaSession *pSession)
{
    IDiaSymbol *pTypeSymbol = NULL;
    if (pSymbol != NULL && pSession != NULL)
    {
        DWORD symbolTypeId;
        pSymbol->get_typeId(&symbolTypeId);
        pSession->symbolById(symbolTypeId, &pTypeSymbol);
    }
    return(pTypeSymbol);
}

Confira também