Partilhar via

IDiaSession::findChildren

  • Artigo

Recupera todos os filhos de um identificador pai especificado que correspondem ao nome e ao tipo de símbolo.

Sintaxe

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

Parâmetros

parent

[in] Um objeto IDiaSymbol que representa o pai. Se esse símbolo pai for uma função, módulo ou bloco, seus filhos léxicos serão retornados em ppResult. Se o símbolo pai for um tipo, seus filhos de classe serão retornados. Se esse parâmetro for NULL, symtag deverá ser definido como SymTagExe ou SymTagNull, que retorna o escopo global (arquivo .exe).

symtag

[in] Especifica a marca de símbolo dos filhos a serem recuperados. Os valores são obtidos da Enumeração SymTagEnum. Defina como SymTagNull para recuperar todos os filhos.

name

[in] Especifica o nome dos filhos a serem recuperados. Defina como NULL para que todos os filhos sejam recuperados.

compareFlags

[in] Especifica as opções de comparação aplicadas à correspondência de nomes. Os valores da enumeração NameSearchOptions podem ser usados sozinhos ou em combinação.

ppResult

[out] Retorna um objeto IDiaEnumSymbols que contém a lista de símbolos filho recuperados.

Valor Retornado

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Exemplo

O exemplo a seguir mostra como localizar variáveis locais de função pFunc que correspondem ao nome szVarName.

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

Confira também