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, optional]

指向一个内存位置,该位置将接收找到 IWiaDrvItem 项的地址。

返回值

如果该方法成功,它将指针存储在 ppItem 中,并返回 S_OK。 如果方法失败,它将 NULL 置于 ppItem 中,并返回 S_FALSE。 如果此方法找不到所需的项,则返回S_FALSE。 如果在搜索期间发生错误,将返回标准 COM 错误代码。

言论

微型驱动程序调用此方法,以在已知项的完整名称时在驱动程序项树中查找项。 项的全名是在 IWiaDrvItem::GetFullItemName 方法获取的。

此方法开始搜索驱动程序项树中根项处的指定项。

要求

要求 价值
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName