IDiaSymbol::findChildrenExByRVA

Retrieves the children of the symbol that are valid at a specified relative virtual address (RVA).

HRESULT findChildrenExByRVA ( 
   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. 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 can be used alone or in combination.

  • address
    [in] Specifies the RVA.

  • 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

Reference

IDiaSymbol

SymTagEnum

IDiaEnumSymbols

IDiaSession::findChildren

NameSearchOptions