IFileOperation::Metode NewItem (shobjidl_core.h)

Artikel
03/04/2024

Menyatakan item baru yang akan dibuat di lokasi tertentu.

Sintaks

HRESULT NewItem(
  [in] IShellItem                 *psiDestinationFolder,
  [in] DWORD                      dwFileAttributes,
  [in] LPCWSTR                    pszName,
  [in] LPCWSTR                    pszTemplateName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parameter

[in] psiDestinationFolder

Jenis: IShellItem*

Penunjuk ke IShellItem yang menentukan folder tujuan yang akan berisi item baru.

[in] dwFileAttributes

Jenis: DWORD

Nilai bitwise yang menentukan atribut sistem file untuk file atau folder. Lihat GetFileAttributes untuk nilai yang mungkin.

[in] pszName

Jenis: LPCWSTR

Arahkan ke nama file item baru, misalnya Newfile.txt. Ini adalah string Unicode yang dihentikan null.

[in] pszTemplateName

Jenis: LPCWSTR

Penunjuk ke nama file templat (misalnya Excel9.xls) yang menjadi dasar item baru, disimpan di salah satu lokasi berikut:

CSIDL_COMMON_TEMPLATES. Jalur default untuk folder ini adalah %ALLUSERSPROFILE%\Templates.
CSIDL_TEMPLATES. Jalur default untuk folder ini adalah %USERPROFILE%\Templates.
%SystemRoot%\shellnew

Ini adalah string Unicode yang dihentikan null yang digunakan untuk menentukan file yang ada dengan jenis yang sama dengan file baru, yang berisi konten minimal yang ingin disertakan aplikasi dalam file baru apa pun.

Parameter ini biasanya NULL untuk menentukan file kosong baru.

[in] pfopsItem

Jenis: IFileOperationProgressSink*

Arahkan ke objek IFileOperationProgressSink yang akan digunakan untuk pemberitahuan status dan kegagalan. Jika Anda memanggil IFileOperation::Advise untuk operasi keseluruhan, status kemajuan dan pemberitahuan kesalahan untuk operasi pembuatan disertakan di sana, jadi atur parameter ini ke NULL.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak membuat item baru, metode ini hanya menyatakan item yang akan dibuat. Untuk membuat item baru, Anda harus membuat setidaknya urutan panggilan yang dirinci di sini:

Panggil IFileOperation::NewItem untuk mendeklarasikan spesifik file atau folder baru.
Panggil IFileOperation::P erformOperations untuk membuat item baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

IFileOperation

PostNewItem

PreNewItem

Bagikan melalui