IDiaSession::symbolByIdIDiaSession::symbolById

Recupera un símbolo de por su identificador único.Retrieves a symbol by its unique identifier.

SintaxisSyntax

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

ParámetrosParameters

id
[in] Identificador único.[in] Unique identifier.

ppSymbol
[out] Devuelve un IDiaSymbol recupera el objeto que representa el símbolo.[out] Returns an IDiaSymbol object that represents the symbol retrieved.

Valor devueltoReturn Value

Si se realiza correctamente, devuelve S_OK; en caso contrario, devuelve un código de error.If successful, returns S_OK; otherwise, returns an error code.

ComentariosRemarks

El identificador especificado es un valor único que se usa internamente el SDK de DIA para hacer que todos los símbolos sea única.The specified identifier is a unique value used internally by the DIA SDK to make all symbols unique.

Este método puede utilizarse, por ejemplo, para recuperar el símbolo que representa el tipo de otro símbolo (vea el ejemplo).This method can be used, for example, to retrieve the symbol representing the type of another symbol (see the example).

EjemploExample

Este ejemplo recupera una IDiaSymbol que representa el tipo de otro símbolo.This example retrieves an IDiaSymbol representing the type of another symbol. Este ejemplo muestra cómo utilizar el symbolById método en la sesión.This example shows how to use the symbolById method in the session. Un enfoque más sencillo consiste en llamar a la idiasymbol:: Get_type método para recuperar el símbolo de tipo directamente.A simpler approach is to call the IDiaSymbol::get_type method to retrieve the type symbol directly.

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

Vea tambiénSee Also

IDiaSession IDiaSession
IDiaSymbol IDiaSymbol
IDiaSymbol::get_typeIDiaSymbol::get_type