IWiaItem2：：FindItemByName 方法

使用名称作为搜索键搜索项的子项树。

语法

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

参数

lFlags [in]

类型： LONG

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

bstrFullItemName [in]

类型： BSTR

指定要搜索的项的名称。

ppIWiaItem2 [out]

类型： IWiaItem2**

接收指向找到的项的 IWiaItem2 接口的指针的地址。

返回值

类型： HRESULT

如果此方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

此方法使用名称作为搜索键来搜索当前项的子项树。 如果 IWiaItem2：：FindItemByName 找到 bstrFullItemName 指定的项，则会在 ppIWiaItem2 参数中存储指向该项 IWiaItem2 接口的指针的地址。

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

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Wia.h
IDL	Wia.idl