IWiaItem：：CreateChildItem 方法 (wia_xp.h)

  • 發行項

應用程式會使用 IWiaItem：：CreateChildItem 方法，將 IWiaItem 物件新增至裝置的 IWiaItem 樹狀結構。

語法

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

參數

[in] lFlags

類型： LONG

指定 WIA 項目類型。 必須設定為 WIA 項目類型旗標中列出的其中一個值。

[in] bstrItemName

類型： BSTR

指定 WIA 專案名稱，例如 「Top」。 您可以將此參數視為相當於檔案名。

[in] bstrFullItemName

類型： BSTR

指定完整的 WIA 項目名稱。 您可以將此參數視為相當於檔案的完整路徑，例如 “003\Root\Top”。

[out] ppIWiaItem

類型： IWiaItem**

接收設定 IWiaItem：：CreateChildItem 方法之 IWiaItem 介面指標的位址。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

某些 WIA 硬體裝置可讓應用程式在代表裝置的 IWiaItem 樹狀結構中建立新專案。 應用程式必須測試裝置，以查看它們是否支援這項功能。 使用 IEnumWIA_DEV_CAPS 介面來列舉目前裝置的功能。

如果裝置允許在 IWiaItem 樹狀結構中建立新專案，叫用 IWiaItem：：CreateChildItem 會建立新的 IWiaItem ，這是目前節點的子系。 IWiaItem：：CreateChildItem 透過 ppIWiaItem 參數將新節點的指標傳遞至應用程式。

應用程式必須在透過 ppIWiaItem 參數收到的介面指標上呼叫 IUnknown：：Release 方法。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 wia_xp.h (包括 Wia.h)
程式庫 Wiaguid.lib
Dll Wiaservc.dll