Freigeben über


IDiaSession::findChildren

Ruft alle untergeordneten Elemente eines angegebenen Elementen Bezeichners ab, die den Namen und den Typ des Symbols übereinstimmen.

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

Parameter

  • parent
    [in] Ein IDiaSymbol-Objekt, das das übergeordnete Element darstellt.Wenn dieses Symbol Elemente eine Funktion, Modul- oder Block befindet, werden die lexikalischen untergeordneten Elemente in ppResultzurückgegeben.Wenn das übergeordnete Symbol ein Typ ist, werden die zugehörigen Klassen untergeordneten Elemente zurückgegeben.Wenn dieser Parameter NULList, muss symtag zu SymTagExe oder SymTagNullfestgelegt werden, der den globalen Bereich (EXE-Datei) zurückgibt.

  • symtag
    [in] Gibt das Symbol tag der untergeordneten Elemente an, die abgerufen werden sollen.Werte werden von der SymTagEnum-Enumeration bestimmt.Auf SymTagNull , um alle untergeordneten Elemente abzurufen.

  • name
    [in] Gibt den Namen der untergeordneten Elemente an, die abgerufen werden sollen.Auf NULL , sodass alle untergeordneten Elemente abgerufen werden können.

  • compareFlags
    [in] Gibt die Vergleichsoptionen, die angewendet werden, um Übereinstimmungen zu benennen.Werte aus der NameSearchOptions-Enumeration können allein oder in Kombination verwendet werden.

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

Rückgabewert

Bei Erfolg gibt S_OKzurück. andernfalls gibt einen Fehlercode zurück.

Beispiel

Im folgenden Beispiel wird gezeigt, wie lokale Variablen der Funktion pFunc Übereinstimmungen sucht die Namen szVarName.

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

Siehe auch

Referenz

IDiaEnumSymbols

IDiaSession

IDiaSymbol

NameSearchOptions

SymTagEnum

Weitere Ressourcen

Übersicht (Debug Interface Access SDK)