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

"Top" などの WIA 項目名を指定します。 このパラメーターは、ファイル名と同等であると考えることができます。

[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 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wia_xp.h (Wia.h を含む)
Library	Wiaguid.lib
[DLL]	Wiaservc.dll