IDiaSession::symbolById

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Retrieves a symbol by its unique identifier.

Syntax

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

Parameters

id
[in] Unique identifier.

ppSymbol
[out] Returns an IDiaSymbol object that represents the symbol retrieved.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

The specified identifier is a unique value used internally by the DIA SDK to make all symbols unique.

This method can be used, for example, to retrieve the symbol representing the type of another symbol (see the example).

Example

This example retrieves an IDiaSymbol representing the type of another symbol. This example shows how to use the symbolById method in the session. 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);  
}  

See Also

IDiaSession
IDiaSymbol
IDiaSymbol::get_type