Fungsi SHAddDefaultPropertiesByExt (shobjidl.h)

Artikel
08/26/2023

Menambahkan properti default ke penyimpanan properti sebagai terdaftar untuk ekstensi file yang ditentukan.

Sintaks

SHSTDAPI SHAddDefaultPropertiesByExt(
  [in] PCWSTR         pszExt,
  [in] IPropertyStore *pPropStore
);

Parameter

[in] pszExt

Jenis: PCWSTR

Penunjuk ke string Unicode yang dihentikan null yang menentukan ekstensi.

[in] pPropStore

Jenis: IPropertyStore*

Penunjuk ke antarmuka IPropertyStore yang menentukan properti default yang akan ditambahkan.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Daftar properti yang digunakan untuk mengatur nilai default berasal dari SetDefaultsFor nilai registri ProgID untuk asosiasi file ekstensi file yang ditentukan. Daftar ini diawali dengan "prop:" dan berisi nama kanonis properti untuk mengatur nilai default, seperti: "prop:System.Author;System.Document.DateCreated". Properti yang mungkin untuk daftar ini adalah System.Author, System.Document.DateCreated, dan System.Photo.DateTaken. SetDefaultsFor Jika nilai tidak ada pada ProgID, fungsi ini menggunakan default yang ditemukan pada SetDefaultsFor nilai HKEY_CLASSES_ROOT*.

System.Author memiliki nilai pengguna yang melakukan tindakan. System.Document.DateCreated dan System.Photo.DateTaken menggunakan tanggal saat ini. Ketiga properti ini adalah satu-satunya yang sistemnya menyediakan default khusus.

Perhatikan bahwa ada beberapa jenis properti:

Properti yang berasal dari sistem file (seperti, ukuran dan tanggal dibuat)
Properti yang berasal dari file (seperti, dimensi dan jumlah halaman)
Properti yang ditempatkan dalam file (seperti, penulis dan tag)

Saat membuat file baru, jenis satu dan dua disediakan hanya dengan membuat file. Tetapi properti tipe tiga harus diatur secara eksplisit oleh program. Sistem ini menyediakan SHAddDefaultPropertiesByExt untuk menyediakan nilai hingga tiga properti tertentu dari tipe tiga. Terkadang Windows Explorer menggunakan API ini saat menyimpan file untuk pertama kalinya, atau saat membuat file baru setelah pilihan menu Baru dipilih dari menu pintasan.

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.h
DLL	Shell32.dll

Bagikan melalui