Metode IFileSaveDialog::ApplyProperties (shobjidl_core.h)

Artikel
03/04/2024

Menerapkan sekumpulan properti ke item menggunakan mesin salinan Shell.

Sintaks

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Parameter

[in] psi

Jenis: IShellItem*

Penunjuk ke IShellItem yang mewakili file yang disimpan. Ini biasanya item yang diambil oleh GetResult.

[in] pStore

Jenis: IPropertyStore*

Penunjuk ke IPropertyStore yang mewakili nilai properti yang akan diterapkan ke file. Ini bisa menjadi penyimpanan properti yang dikembalikan oleh IFileSaveDialog::GetProperties.

[in] hwnd

Jenis: HWND

Handel jendela aplikasi.

[in] pSink

Jenis: IFileOperationProgressSink*

Arahkan ke IFileOperationProgressSink opsional yang dapat digunakan aplikasi panggilan jika mereka ingin diberi tahu tentang kemajuan stempel properti. Nilai ini mungkin NULL.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Metode ini harus digunakan ketika aplikasi telah mengaktifkan koleksi properti (IFileSaveDialog::SetCollectedProperties), tetapi tidak mempertahankan properti itu sendiri ke dalam file yang disimpan.

Catatan File yang diwakili oleh item yang ditentukan dalam psi harus ada di penyimpanan fisik sebelum melakukan panggilan ke IFileSaveDialog::ApplyProperties, sehingga sebelumnya harus disimpan di beberapa titik.

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

Bagikan melalui