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 で終わる Unicode 文字列です。

このパラメーターは通常、新しい空のファイルを指定する 場合は NULL です 。

[in] pfopsItem

種類: IFileOperationProgressSink*

状態と失敗の通知に使用する IFileOperationProgressSink オブジェクトへのポインター。 操作全体に対して IFileOperation::Advise を呼び出すと、作成操作の進行状況とエラー通知がそこに含まれるため、このパラメーターを NULL に設定します。

戻り値

型: HRESULT

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

注釈

このメソッドは新しい項目を作成せず、作成する項目を宣言するだけです。 新しいアイテムを作成するには、少なくともここで詳しく説明する一連の呼び出しを行う必要があります。

  1. IFileOperation::NewItem を呼び出して、新しいファイルまたはフォルダーの詳細を宣言します。
  2. IFileOperation::P erformOperations を呼び出して、新しい項目を作成します。

要件

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

こちらもご覧ください

IFileOperation

PostNewItem

PreNewItem