Edit

Share via

IDiaSymbol::findChildren

  • Article

Retrieves the children of the symbol.

Syntax

HRESULT findChildren ( 
   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 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 identical to calling the IDiaSession::findChildren method with this symbol as the first parameter.

This method finds only the children of the current symbol. For example, public symbols (SymTagPublicSymbol) are children only of the global scope, regardless of whether the Function symbol or Data symbol that they refer to might be children of other symbols (such as Compilands, types, and others). For a list of symbol types, see Lexical Hierarchy of Symbol Types.

See also