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 错误代码。

注解

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

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

要求

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

另请参阅

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName