次の方法で共有

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を返します。 メソッドが失敗した場合、ppItemNULL を配置し、S_FALSEを返します。 このメソッドが必要な項目を見つけられない場合は、S_FALSEを返します。 検索中にエラーが発生した場合は、標準の COM エラー コードが返されます。

備考

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー wiamindr_lh.h (Wiamindr.h を含む)

関連項目

IWiaDrvItem の

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName