共用方式為

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 找到的一或多個值。

[in] hrNew

類型： HRESULT

建立作業的傳回值。 請注意，這不是 NewItem 所傳回的 HRESULT，這隻會將建立作業排入佇列。 相反地，這是實際建立的結果。

[in] psiNewItem

類型： IShellItem*

代表新專案的 IShellItem 指標。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值。 如果發生錯誤值，則會取消從 IFileOperation 呼叫擱置的所有後續作業。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)