IDiaSymbol::findChildrenExByVA

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