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) |