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

アイテムまたはアイテムに設定するプロパティと値のセットを宣言します。

構文

HRESULT SetProperties(
  [in] IPropertyChangeArray *pproparray
);

パラメーター

[in] pproparray

種類: IPropertyChangeArray*

設定するプロパティとその新しい値を指定する IPropertyChange オブジェクトのコレクションにアクセスする IPropertyChangeArray へのポインター。

戻り値

種類: HRESULT

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

注釈

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

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)