IFileOperationProgressSink::P ostNewItem メソッド (shobjidl_core.h)

  • [アーティクル]

新しい項目が作成された後に、呼び出し元によって実装されるアクションを実行します。

構文

HRESULT PostNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] LPCWSTR    pszTemplateName,
  [in] DWORD      dwFileAttributes,
  [in] HRESULT    hrNew,
  [in] IShellItem *psiNewItem
);

パラメーター

[in] dwFlags

型: DWORD

作成操作中に使用されたフラグを含むビットごとの値。 一部の値は、作成操作中に設定または変更できます。 フラグの説明については 、「TRANSFER_SOURCE_FLAGS 」を参照してください。

[in] psiDestinationFolder

種類: IShellItem*

新しい項目が追加された宛先フォルダーを指定する IShellItem へのポインター。

[in] pszNewName

種類: 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] dwFileAttributes

型: DWORD

新しい項目に適用されるファイル属性。 GetFileAttributes にある 1 つ以上の値。

[in] hrNew

種類: HRESULT

作成操作の戻り値。 これは NewItem によって返される HRESULT ではなく、作成操作をキューに入れるだけです。 代わりに、これは実際の作成の結果です。

[in] psiNewItem

種類: IShellItem*

新しい項目を表す IShellItem へのポインター。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。 エラー値の場合、 IFileOperation の呼び出しから保留中のすべての後続の操作が取り消されます。

要件

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