IFileOperation::NewItem メソッド (shobjidl_core.h)
指定した場所に作成される新しい項目を宣言します。
構文
HRESULT NewItem(
[in] IShellItem *psiDestinationFolder,
[in] DWORD dwFileAttributes,
[in] LPCWSTR pszName,
[in] LPCWSTR pszTemplateName,
[in] IFileOperationProgressSink *pfopsItem
);
パラメーター
[in] psiDestinationFolder
種類: IShellItem*
新しい項目を含む移動先フォルダーを指定する IShellItem へのポインター。
[in] dwFileAttributes
型: DWORD
ファイルまたはフォルダーのファイル システム属性を指定するビットごとの値。 使用可能な値については、「 GetFileAttributes 」を参照してください。
[in] pszName
種類: LPCWSTR
新しい項目のファイル名へのポインター (例: Newfile.txt)。 これは null で終わる Unicode 文字列です。
[in] pszTemplateName
種類: LPCWSTR
新しい項目の基になっているテンプレート ファイルの名前 ( Excel9.xlsなど) へのポインターは、次のいずれかの場所に格納されます。
- CSIDL_COMMON_TEMPLATES。 このフォルダーの既定のパスは %ALLUSERSPROFILE%\Templates です。
- CSIDL_TEMPLATES。 このフォルダーの既定のパスは %USERPROFILE%\Templates です。
- %SystemRoot%\shellnew
このパラメーターは通常、新しい空のファイルを指定する 場合は NULL です 。
[in] pfopsItem
種類: IFileOperationProgressSink*
状態と失敗の通知に使用する IFileOperationProgressSink オブジェクトへのポインター。 操作全体に対して IFileOperation::Advise を呼び出すと、作成操作の進行状況とエラー通知がそこに含まれるため、このパラメーターを NULL に設定します。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
このメソッドは新しい項目を作成せず、作成する項目を宣言するだけです。 新しいアイテムを作成するには、少なくともここで詳しく説明する一連の呼び出しを行う必要があります。
- IFileOperation::NewItem を呼び出して、新しいファイルまたはフォルダーの詳細を宣言します。
- IFileOperation::P erformOperations を呼び出して、新しい項目を作成します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |