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

IWiaDrvItem::FindItemByName メソッドは、ドライバー項目ツリー内の項目を項目の完全な名前で検索します。

構文

HRESULT FindItemByName(
  LONG        __MIDL__IWiaDrvItem0007,
  BSTR        __MIDL__IWiaDrvItem0008,
  IWiaDrvItem **__MIDL__IWiaDrvItem0009
);

パラメーター

__MIDL__IWiaDrvItem0007

bstrFullItemName [in]

検索するアイテムの完全な名前を指定します。

__MIDL__IWiaDrvItem0008

lFlags [in]

予約済み。 0 に設定します。

__MIDL__IWiaDrvItem0009

ppItem [out, optional]

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

戻り値

メソッドが成功した場合、見つかった項目へのポインターを ppItem に格納し、 S_OKを返します。 メソッドが失敗した場合は、ppItem に NULL を配置し、S_FALSEを返します。 このメソッドが必要な項目を見つけられない場合は、S_FALSEを返します。 検索中にエラーが発生した場合は、標準の COM エラー コードが返されます。

注釈

ミニドライバーは、このメソッドを呼び出して、項目の完全な名前がわかっている場合にドライバー項目ツリー内の項目を検索します。 アイテムの完全な名前は、 メソッド IWiaDrvItem::GetFullItemName で取得されます。

このメソッドは、ドライバー項目ツリーのルート項目で指定された項目の検索を開始します。

要件

こちらもご覧ください

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName