IDiaSymbol::findChildrenExByVA

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 virtual address.

Syntax

HRESULT findChildrenExByVA (   
   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] Specifies the virtual address.

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

See Also

IDiaSymbol
SymTagEnum Enumeration
IDiaEnumSymbols
IDiaSession::findChildren
NameSearchOptions Enumeration