IWiaDrvItem::FindChildItemByName メソッド (wiamindr_lh.h)

IWiaDrvItem::FindChildItemByName メソッドは、ドライバー項目ツリーで特定の子項目を検索します。

構文

HRESULT FindChildItemByName(
  BSTR        __MIDL__IWiaDrvItem0010,
  IWiaDrvItem **__MIDL__IWiaDrvItem0011
);

__MIDL__IWiaDrvItem0010

bstrChildItemName [in]

検索する子項目のパス情報を含む名前を含む文字列を指定します。

__MIDL__IWiaDrvItem0011

ppIChildItem [out, optional]

見つかった IWiaDrvItem 子項目のアドレスを受け取るメモリの場所を指します。

メソッドが成功した場合は、見つかった子項目へのポインターを ppIChildItem に格納し、 S_OKを返します。メソッドが子項目を見つけられない場合は、 S_FALSEを返します。別の理由でメソッドが失敗した場合は、標準の COM エラーコードが返されます。

ミニドライバーは通常、このメソッドを使用して、子項目の名前がわかっている場合に特定の子項目のドライバー項目ツリーを検索します。子項目の完全な名前は、メソッド IWiaDrvItem::GetFullItemName で取得されます。

要件	値
対象プラットフォーム	デスクトップ
Header	wiamindr_lh.h (Wiamindr.h を含む)