Merge pull request #13851 from Mikejo5000/mikejo-br25

Clarify behavior for IDiaSymbol::findChildren

Author: prmerger-automator[bot]

docs/debugger/debug-interface-access/idiasymbol-findchildren.md

@@ -1,7 +1,7 @@
 ---
 description: Retrieves the children of the symbol.
 title: "IDiaSymbol::findChildren"
-ms.date: "11/04/2016"
+ms.date: "04/22/2025"
 ms.topic: "reference"
 dev_langs:
   - "C++"
@@ -51,6 +51,8 @@ HRESULT findChildren (
 ## Remarks
  This method is identical to calling the [IDiaSession::findChildren](../../debugger/debug-interface-access/idiasession-findchildren.md) 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](../debug-interface-access/lexical-hierarchy-of-symbol-types.md).
+
 ## See also
 - [IDiaSymbol](../../debugger/debug-interface-access/idiasymbol.md)
 - [SymTagEnum Enumeration](../../debugger/debug-interface-access/symtagenum.md)

docs/debugger/debug-interface-access/idiasymbol.md

@@ -1,7 +1,7 @@
 ---
 description: "Describes the properties of a symbol instance."
 title: "IDiaSymbol"
-ms.date: "07/08/2024"
+ms.date: "04/22/2025"
 ms.topic: "reference"
 dev_langs:
   - "C++"
@@ -27,7 +27,7 @@ IDiaSymbol : IUnknown
 The following table shows the methods of `IDiaSymbol`.
 
 > [!NOTE]
-> Symbols will return meaningful data for only some of these methods, depending on the type of symbol. If a method returns `S_OK`, then that method has returned meaningful data.
+> Symbols will return meaningful data for only some of these methods, depending on the type of symbol. If a method returns `S_OK`, then that method has returned meaningful data. For a list of symbol types, see [Lexical Hierarchy of Symbol Types](../debug-interface-access/lexical-hierarchy-of-symbol-types.md).
 
 |Method|Description|
 |------------|-----------------|