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