通过

IWiaItem：：FindItemByName 方法 (wia_xp.h)

  • 项目

IWiaItem：：FindItemByName 方法使用名称作为搜索键来搜索项的子项树。 每个 IWiaItem 对象都有一个名称作为其标准属性之一。

语法

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

参数

[in] lFlags

类型： LONG

当前未使用。 应设置为零。

[in] bstrFullItemName

类型： BSTR

指定要搜索的项的名称。

[out] ppIWiaItem

类型： IWiaItem**

指向 IWiaItem 接口的 指针。

返回值

类型： HRESULT

如果找到项，则此方法返回S_OK;如果找不到项，则返回S_FALSE。 如果方法失败，则返回标准 COM 错误代码。

注解

此方法使用名称作为搜索键来搜索当前项的子项树。 如果 IWiaItem：：FindItemByName 查找由 bstrFullItemName 指定的项，它将在 ppIWiaItem 参数中存储指向项的 IWiaItem 接口的指针的地址。

应用程序必须在通过 ppIWiaItem 参数接收的接口指针上调用 IUnknown：：Release 方法。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wia_xp.h (包括 Wia.h)
Library Wiaguid.lib
DLL Wiaservc.dll