IDiaSymbol::findChildrenEx

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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. The local symbols that are returned include live range information, if the program is compiled with optimization on.

Syntax

HRESULT findChildrenEx ( 
   enum SymTagEnum   symtag,
   LPCOLESTR         name,
   DWORD             compareFlags,
   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.

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

This method is the extended version of IDiaSymbol::findChildren.

Requirements

Header: Dia2.h

Library: diaguids.lib

DLL: msdia100.dll

See also