Fungsi SHSetDefaultProperties (shobjidl.h)

Artikel
03/15/2023

Menerapkan kumpulan properti default pada item Shell.

Sintaks

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

Parameter

[in, optional] hwnd

Jenis: HWND

Handel ke jendela induk item, yang menerima pemberitahuan kesalahan. Nilai ini bisa NULL.

[in] psi

Jenis: IShellItem*

Penunjuk ke objek IShellItem yang mewakili item.

dwFileOpFlags

Jenis: DWORD

Bendera yang menyesuaikan operasi. Lihat IFileOperation::SetOperationFlags untuk nilai bendera.

[in, optional] pfops

Jenis: IFileOperationProgressSink*

Penunjuk ke objek IFileOperationProgressSink yang digunakan untuk mengikuti kemajuan operasi. Lihat IFileOperation::Advise untuk detailnya. Nilai ini bisa NULL.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Daftar properti untuk mengatur nilai default berasal dari entri SetDefaultsFor registri di bawah ProgID untuk asosiasi file item. Daftar ini diawali dengan "prop:" dan berisi nama kanonis properti untuk mengatur nilai default, misalnya, "prop:System.Author;System.Document.DateCreated". Properti yang mungkin untuk daftar ini adalah System.Author, System.Document.DateCreated, dan System.Photo.DateTaken. Jika entri SetDefaultsFor tidak ada di ProgID, fungsi ini menggunakan default yang ditemukan pada entri SetDefaultsForHKEY_CLASSES_ROOT\*.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h
Pustaka	Shell32.lib
DLL	Shell32.dll

Bagikan melalui