IDiaSession::findChildrenIDiaSession::findChildren

Récupère tous les enfants d’un identificateur parent spécifié qui correspond 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 qui représente 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 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 avoir la valeur 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 symbol des enfants doit être récupéré.[in] Specifies the symbol tag of the children to be retrieved. Les valeurs sont tirées 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 de l’enfant doit être récupéré.[in] Specifies the name of the children to be retrieved. La valeur NULL pour tous les enfants doivent être récupérés.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 à partir 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 enfants.[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 la 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ération)SymTagEnum Enumeration