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