共用方式為

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：：建議 ，則會在該處包含建立作業的進度狀態和錯誤通知，因此請將此參數設定為 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