IDiaSymbol::findChildrenExByAddr

Article
11/15/2016

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 the children of the symbol that are valid at a specified address.

Syntax

HRESULT findChildrenExByAddr (   
   enum SymTagEnum   symtag,  
   LPCOLESTR         name,  
   DWORD             compareFlags,  
   DWORD             address,  
   IDiaEnumSymbols** ppResult  
);

Parameters

symtag
[in] Specifies the symbol tags of the children to be retrieved, as defined in the SymTagEnum Enumeration. Set to SymTagNull for all children to be retrieved.

name
[in] Specifies the name of the children to be retrieved. Set to NULL for all children to be retrieved.

compareFlags
[in] Specifies the comparison options to be applied to name matching. Values from the NameSearchOptions Enumeration enumeration can be used alone or in combination.

address
[in] The address of the symbol.

ppResult
[out] Returns an IDiaEnumSymbols object that contains a list of the child symbols retrieved.

Return Value

Returns S_OK if at least one child of the symbol was found, or returns S_FALSE if no children were found; otherwise, returns an error code.

Remarks

The local symbols that are returned include live range information.

Requirements

Header: Dia2.h

Library: diaguids.lib

DLL: msdia100.dll

Share via