IDiaSession::findChildrenIDiaSession::findChildren

Récupère tous les enfants d’un identificateur du parent spécifié qui correspondent au type de nom et le symbole.Retrieves all children of a specified parent identifier that match the name and symbol type.

SyntaxeSyntax

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

ParamètresParameters

parent
[in] Un IDiaSymbol objet représentant le parent.[in] An IDiaSymbol object representing the parent. Si ce symbole parent est une fonction, un module ou un bloc, ses enfants lexicales sont retournées dans ppResult.If this parent symbol is a function, module, or block, then its lexical children are returned in ppResult. Si le symbole de parent est un type, ses enfants de la classe sont retournées.If the parent symbol is a type, then its class children are returned. Si ce paramètre est NULL, puis symtag doit être définie sur SymTagExe ou SymTagNull, qui retourne la portée globale (fichier .exe).If this parameter is NULL, then symtag must be set to SymTagExe or SymTagNull, which returns the global scope (.exe file).

symtag
[in] Spécifie la balise de symbole des enfants à récupérer.[in] Specifies the symbol tag of the children to be retrieved. Les valeurs sont extraites à partir de la SymTagEnum (énumération) énumération.Values are taken from the SymTagEnum Enumeration enumeration. La valeur SymTagNull pour récupérer tous les enfants.Set to SymTagNull to retrieve all children.

name
[in] Spécifie le nom des enfants à récupérer.[in] Specifies the name of the children to be retrieved. La valeur NULL pour tous les enfants doivent être récupérées.Set to NULL for all children to be retrieved.

compareFlags
[in] Spécifie les options de comparaison appliquées à la correspondance de noms.[in] Specifies the comparison options applied to name matching. Les valeurs de la NameSearchOptions (énumération) énumération peut être utilisée seul ou combiné.Values from the NameSearchOptions Enumeration enumeration can be used alone or in combination.

ppResult
[out] Retourne un IDiaEnumSymbols de récupérer l’objet qui contient la liste des symboles de l’enfant.[out] Returns an IDiaEnumSymbols object that contains the list of child symbols retrieved.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK; sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code.

ExempleExample

L’exemple suivant montre comment rechercher des variables locales de fonction pFunc ce nom de la correspondance szVarName.The following example shows how to find local variables of function pFunc that match name szVarName.

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

Voir aussiSee Also

Vue d’ensemble Overview
IDiaEnumSymbols IDiaEnumSymbols
IDiaSession IDiaSession
IDiaSymbol IDiaSymbol
NameSearchOptions (énumération) NameSearchOptions Enumeration
SymTagEnum, énumérationSymTagEnum Enumeration