Partilhar via


IDiaSession::symbolById

Recupera um símbolo por seu identificador exclusivo.

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

Parâmetros

  • id
    [in] Identificador exclusivo.

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

Valor de retorno

Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.

Comentários

O identificador especificado é um valor exclusivo usado internamente pelo SDK do DIA para fazer com que todos os símbolos exclusivo.

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

Exemplo

Este exemplo recupera uma IDiaSymbol que representa o tipo de outro símbolo.Este exemplo mostra como usar o symbolById método na sessão.Uma abordagem mais simples é chamar o IDiaSymbol::get_type método 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);
}

Consulte também

Referência

IDiaSession

IDiaSymbol

IDiaSymbol::get_type