Fungsi SHGetSetFolderCustomSettings (shlobj_core.h)

Artikel
03/04/2024

[SHGetSetFolderCustomSettings tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Mengatur atau mengambil pengaturan folder kustom. Fungsi ini membaca dari dan menulis ke Desktop.ini.

Sintaks

SHSTDAPI SHGetSetFolderCustomSettings(
  [in, out] LPSHFOLDERCUSTOMSETTINGS pfcs,
  [in]      PCWSTR                   pszPath,
            DWORD                    dwReadWrite
);

Parameter

[in, out] pfcs

Jenis: LPSHFOLDERCUSTOMSETTINGS

Penunjuk ke struktur SHFOLDERCUSTOMSETTINGS yang menyediakan atau menerima pengaturan folder kustom.

[in] pszPath

Jenis: PCTSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur ke folder. Panjang pszPath harus MAX_PATH atau kurang, termasuk karakter null yang mengakhiri.

dwReadWrite

Jenis: DWORD

Bendera yang mengontrol tindakan fungsi. Ini mungkin salah satu nilai berikut.

FCS_READ (0x00000001)

Ambil pengaturan folder kustom dalam pfcs.

FCS_FORCEWRITE (0x00000002)

Gunakan pfc untuk mengatur pengaturan folder kustom terlepas dari apakah nilai sudah ada.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Gunakan pfcs untuk mengatur pengaturan folder kustom jika nilai belum ada.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Hanya string Unicode yang didukung.

Windows Server 2003 dan Windows XP: SHGetSetFolderCustomSettings mendukung string ANSI dan Unicode.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.0 atau yang lebih baru)

Bagikan melalui