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 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 wia_xp.h (包含 Wia.h)
程式庫 Wiaguid.lib
Dll Wiaservc.dll