IFileOperation::ApplyPropertiesToItems メソッド (shobjidl_core.h)

共通のプロパティ値のセットを適用する項目のセットを宣言します。

構文

HRESULT ApplyPropertiesToItems(
  [in] IUnknown *punkItems
);

パラメーター

[in] punkItems

種類: IUnknown*

項目のグループを表す IShellItemArray、IDataObject、または IEnumShellItems オブジェクトの IUnknown へのポインター。 IPersistIDList オブジェクトをポイントして 1 つの項目を表すこともできます。IFileOperation::ApplyPropertiesToItem と同じ関数を効果的に実行できます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、項目にプロパティを適用せず、単に項目を宣言します。 項目のグループにプロパティ値を設定するには、少なくともここで詳しく説明する一連の呼び出しを行う必要があります。

1. IFileOperation::SetProperties を呼び出して、設定する特定のプロパティとその新しい値を宣言します。
2. IFileOperation::ApplyPropertiesToItems を呼び出して、プロパティ値を設定するアイテムを宣言します。
3. IFileOperation::P erformOperations を呼び出して、アイテムにプロパティを適用します。

要件

関連項目

IFileOperation

IFileOperation::ApplyPropertiesToItem