IDiaSession::findChildren

  • Artikel

Ruft alle untergeordneten Elemente eines angegebenen übergeordneten Bezeichners ab, die mit dem Namen und Symboltyp übereinstimmen.

Syntax

HRESULT findChildren ( 
   IDiaSymbol*       parent,
   SymTagEnum        symtag,
   LPCOLESTR         name,
   DWORD             compareFlags,
   IDiaEnumSymbols** ppResult
);

Parameter

parent

[in] Ein IDiaSymbol-Objekt, das das übergeordnete Element darstellt. Handelt es sich bei diesem übergeordneten Symbol um eine Funktion, ein Modul oder einen Block, werden die untergeordneten lexikalischen Elemente in ppResult zurückgegeben. Handelt es sich um einen Typ, werden die untergeordneten Klassen zurückgegeben. Ist dieser Parameter NULL, muss symtag auf SymTagExe oder SymTagNull festgelegt werden. Dadurch wird der globale Gültigkeitsbereich zurückgegeben (EXE-Datei).

symtag

[in] Gibt das Symboltag der untergeordneten Elemente an, die abgerufen werden sollen. Die Werte werden aus der SymTagEnum-Enumeration übernommen. Bei SymTagNull werden alle untergeordneten Elemente abgerufen.

name

[in] Gibt den Namen der untergeordneten Elemente an, die abgerufen werden sollen. Bei NULL werden alle untergeordneten Elemente abgerufen.

compareFlags

[in] Gibt die Vergleichsoptionen an, die auf die Namensübereinstimmung angewendet werden. Die Werte aus der NameSearchOptions-Enumeration können allein oder kombiniert verwendet werden.

ppResult

[out] Gibt ein IDiaEnumSymbols-Objekt zurück, das die Liste der abgerufenen untergeordneten Symbole enthält.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben.

Beispiel

Das folgende Beispiel zeigt, wie Sie lokale Variablen der pFunc-Funktion finden, die mit dem Namen szVarName übereinstimmen.

IDiaEnumSymbols* pEnum;
pSession->findChildren( pFunc, SymTagData, szVarName, nsCaseSensitive, &pEnum );

Weitere Informationen