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 です 。

[in] dwFileAttributes

型: DWORD

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

[in] hrNew

種類: HRESULT

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

[in] psiNewItem

種類: IShellItem*

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

戻り値

種類: HRESULT

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

要件