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 で取得されます。
このメソッドは、ドライバー項目ツリーのルート項目で指定された項目の検索を開始します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamindr_lh.h (Wiamindr.h を含む) |