共用方式為


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