共用方式為


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]

保留的。 設定為零。

__MIDL__IWiaDrvItem0009

ppItem [out, 選擇性]

指向將接收所找到 IWiaDrvItem 專案的位址的記憶體位置。

傳回值

如果方法成功,它會將找到專案的指標儲存在 ppItem 中,並傳回 S_OK。 如果方法失敗,它會在ppItem中放置NULL,並傳回S_FALSE。 如果這個方法找不到必要的專案,則會傳回S_FALSE。 如果在搜尋期間發生錯誤,將會傳回標準 COM 錯誤碼。

備註

Minidrivers 會呼叫這個方法,以在已知專案的完整名稱時,在驅動程式專案樹狀目錄中尋找專案。 專案的完整名稱是在 IWiaDrvItem::GetFullItemName 方法中取得。

這個方法會在驅動程式專案樹狀目錄中的根項目開始搜尋指定的專案。

規格需求

需求
目標平台 桌面
標頭 wiamindr_lh.h (包括 Wiamindr.h)

另請參閱

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName