IDiaSession::findChildren

  • [アーティクル]

指定された親識別子の子で、名前とシンボルの種類に一致するものをすべて取得します。

構文

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

パラメーター

parent

[入力] 親を表す IDiaSymbol オブジェクト。 この親シンボルが関数、モジュール、またはブロックの場合、その構文上の子が ppResult で返されます。 親シンボルが型の場合は、そのクラスの子が返されます。 このパラメーターが NULL の場合は、symtag を SymTagExe または SymTagNull に設定する必要があります。これにより、グローバル スコープ (.exe ファイル) が返されます。

symtag

[入力] 取得する子のシンボル タグを指定します。 値は、SymTagEnum 列挙型の列挙体から取得されます。 すべての子を取得するには、SymTagNull に設定します。

name

[入力] 取得する子の名前を指定します。 すべての子を取得するには、NULL に設定します。

compareFlags

[入力] 名前の照合に適用する比較オプションを指定します。 NameSearchOptions 列挙型に関する記事の列挙型の値は、単独で使用することも、組み合わせて使用することもできます。

ppResult

[出力] 取得された子シンボルの一覧を含む IDiaEnumSymbols オブジェクトを返します。

戻り値

成功した場合は、S_OK を返します。それ以外の場合は、エラー コードを返します。

例

次の例では、名前 szVarName に一致する関数 pFunc のローカル変数を検索する方法を示します。

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

関連項目