IWiaItem2::CreateChildItem メソッド

新しい子項目を作成します。 IWiaItem2 オブジェクトをデバイスの IWiaItem2 ツリーに追加します。

構文

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

パラメーター

lItemFlags [in]

型: LONG

WIA 2.0 項目の種類を指定します。 WIA 項目の種類フラグを参照してください。

lCreationFlags [in]

型: LONG

新しい項目を作成する方法を指定します。

0 (0)

子のプロパティの既定値を設定します。

COPY_PARENT_PROPERTY_VALUES (0x40000000)

すべての読み取り/書き込みプロパティの値を親からコピーします。

bstrItemName [in]

型: BSTR

項目名を指定します。 この名前は、親アイテムの名前の末尾に追加され、完全なアイテム名が生成されます。

ppIWiaItem2 [out]

型: IWiaItem2**

IWiaItem2::CreateChildItem メソッドを設定する IWiaItem2 インターフェイスへのポインターのアドレスを受け取ります。

戻り値

型: HRESULT

このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

解説

一部の WIA 2.0 ハードウェア デバイスでは、アプリケーションがデバイスを表す IWiaItem2 ツリーに新しい項目を作成できます。 アプリケーションはこの機能をサポートしているかどうかを確認するためにデバイスをテストする必要があります。 IEnumWIA_DEV_CAPS インターフェイスを使用して、現在のデバイスの機能を列挙します。

デバイスで IWiaItem2 ツリーで新しい項目を作成できる場合、 IWiaItem2::CreateChildItem を呼び出すと、現在のノードの子である新しい IWiaItem2 オブジェクトが作成されます。 ppIWiaItem2 パラメーターを使用して、新しいノードへのポインターをアプリケーションに渡します。 アプリケーションは、ppIWiaItem2 パラメーターを介して受け取るインターフェイス ポインターで IUnknown::Release メソッドを呼び出す必要があります。

lCreationFlags がCOPY_PARENT_PROPERTY_VALUESされ、lItemFlags が 0 の場合、この関数はE_INVALIDARGを返します。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	Wia.h
IDL	Wia.idl