Metode ITransferDestination::CreateItem (shobjidl_core.h)

Artikel
08/26/2023

Membuat file yang ditentukan.

Sintaks

HRESULT CreateItem(
  [in]  LPCWSTR               pszName,
  [in]  DWORD                 dwAttributes,
  [in]  ULONGLONG             ullSize,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] REFIID                riidItem,
  [out] void                  **ppvItem,
  [in]  REFIID                riidResources,
  [out] void                  **ppvResources
);

Parameter

[in] pszName

Jenis: LPCWSTR

Penunjuk ke buffer yang dihentikan null yang berisi nama file relatif terhadap direktori saat ini.

[in] dwAttributes

Jenis: DWORD

Satu atau beberapa bendera FILE_ATTRIBUTE yang ditentukan dalam struktur BY_HANDLE_FILE_INFORMATION . Nilai yang paling signifikan adalah FILE_ATTRIBUTE_DIRECTORY, yang menunjukkan bahwa folder harus dibuat.

[in] ullSize

Jenis: ULONGLONG

Ukuran, dalam byte, dari file yang akan dibuat. Nilai ini bisa 0 jika ukurannya tidak diketahui.

[in] flags

Jenis: TRANSFER_SOURCE_FLAGS

Bendera yang mengontrol operasi file. Satu atau beberapa bendera TRANSFER_SOURCE_FLAGS .

[out] riidItem

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppvItem, biasanya IID_IShellItem atau antarmuka lain yang berasal dari antarmuka tersebut.

[out] ppvItem

Jenis: batal**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta di riidItem. Ini biasanya IShellItem atau antarmuka turunan.

[in] riidResources

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppvResources, biasanya IID_IShellItemResources atau antarmuka lain yang berasal dari antarmuka tersebut.

[out] ppvResources

Jenis: batal**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta di riidResources. Ini biasanya IShellItemResources atau antarmuka turunan.

Nilai kembali

Jenis: HRESULT

Mengembalikan kode keberhasilan jika berhasil, atau nilai kesalahan sebaliknya. Kode keberhasilan meliputi:

S_OK: Pemindahan berhasil dan ppvItem dan ppvResources keduanya menunjuk ke objek yang valid.
COPYENGINE_S_USER_IGNORED: Item tujuan sudah ada dan belum ditimpa. Nilai yang ditujukkan oleh ppvItem dan ppvResources adalah NULL. Jika pemanggil menerapkan pemindahan sebagai operasi salin dan hapus, pemanggil harus menyelesaikan pemindahan dengan menghapus item sumber.

Keterangan

Metode ini dapat digunakan untuk membuat objek item Shell yang mewakili folder tujuan untuk operasi salin atau pindah. Antarmuka ITransferSource menyediakan metode untuk benar-benar memindahkan objek IShellItem ke tujuan.

Panggil ITransferDestination::Advise sebelum memanggil metode ITransferDestination lainnya sehingga handler dapat memanggil balik pada kesalahan apa pun yang mungkin terjadi. Jika tidak diatur, handler harus menganggapnya sebagai indikasi bahwa tidak ada umpan balik yang tersedia dan untuk melakukan operasi "default".

Disarankan agar Anda menggunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk mengemas parameter riidResources dan ppvResources . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang ditujukkan oleh nilai dalam ppvResources, yang menghilangkan kemungkinan kesalahan pengkodian.

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)

Bagikan melalui