IFileOperation::RenameItems メソッド (shobjidl_core.h)
新しい表示名を指定する項目のセットを宣言します。 すべての項目に同じ名前が付けられます。
構文
HRESULT RenameItems(
[in] IUnknown *pUnkItems,
[in] LPCWSTR pszNewName
);
パラメーター
[in] pUnkItems
種類: IUnknown*
名前を変更する項目のグループを表す IShellItemArray、IDataObject、または IEnumShellItems オブジェクトの IUnknown へのポインター。 また、IPersistIDList オブジェクトをポイントして 1 つの項目を表し、IFileOperation::RenameItem と同じ関数を効果的に実行することもできます。
[in] pszNewName
種類: LPCWSTR
項目の新しい表示名へのポインター。 これは null で終わる Unicode 文字列です。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
pUnkItems にあるコレクション内の複数の項目が同じフォルダー内にある場合、名前が変更されたファイルにはかっこで囲まれた番号が付加され、区別されます (例: newfile(1).txt、newfile(2).txt、newfile(3).txt)。
このメソッドは項目の名前を変更せず、名前を変更する項目を宣言するだけです。 オブジェクトのグループの名前を変更するには、少なくともここで詳しく説明されている一連の呼び出しを行う必要があります。
- IFileOperation::RenameItems を呼び出して、ソース ファイルまたはフォルダーと新しい名前を宣言します。
- IFileOperation::P erformOperations を呼び出して、名前変更操作を開始します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |