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