Struktur SHFOLDERCUSTOMSETTINGS (shlobj_core.h)

Menyimpan pengaturan folder kustom. Struktur ini digunakan dengan fungsi SHGetSetFolderCustomSettings .

Sintaks

typedef struct {
  DWORD       dwSize;
  DWORD       dwMask;
  SHELLVIEWID *pvid;
  LPWSTR      pszWebViewTemplate;
  DWORD       cchWebViewTemplate;
  LPWSTR      pszWebViewTemplateVersion;
  LPWSTR      pszInfoTip;
  DWORD       cchInfoTip;
  CLSID       *pclsid;
  DWORD       dwFlags;
  LPWSTR      pszIconFile;
  DWORD       cchIconFile;
  int         iIconIndex;
  LPWSTR      pszLogo;
  DWORD       cchLogo;
} SHFOLDERCUSTOMSETTINGS, *LPSHFOLDERCUSTOMSETTINGS;

Anggota

dwSize

Jenis: DWORD

Ukuran struktur, dalam byte.

dwMask

Jenis: DWORD

Nilai DWORD yang menentukan atribut folder mana yang akan dibaca atau ditulis dari struktur ini. Gunakan satu atau beberapa nilai berikut untuk menunjukkan anggota struktur mana yang valid:

FCSM_VIEWID

Tidak digunakan lagi. pvid berisi GUID folder.

FCSM_WEBVIEWTEMPLATE

Tidak digunakan lagi. pszWebViewTemplate berisi penunjuk ke buffer yang berisi jalur ke templat WebView folder.

FCSM_INFOTIP

pszInfoTip berisi penunjuk ke buffer yang berisi tip info folder.

FCSM_CLSID

pclsid berisi CLSID folder.

FCSM_ICONFILE

pszIconFile berisi jalur ke file yang berisi ikon folder.

FCSM_LOGO

pszLogo berisi jalur ke file yang berisi ikon gambar mini folder.

FCSM_FLAGS

Tidak digunakan.

pvid

Jenis: SHELLVIEWID*

GUID folder.

pszWebViewTemplate

Jenis: LPTSTR

Penunjuk ke string yang dihentikan null yang berisi jalur ke templat WebView folder.

cchWebViewTemplate

Jenis: DWORD

Jika parameter SHGetSetFolderCustomSettingsdwReadWriteFCS_READ, ini adalah ukuran buffer pszWebViewTemplate , dalam karakter. Jika tidak, ini adalah jumlah karakter yang akan ditulis dari buffer tersebut. Atur parameter ini ke 0 untuk menulis seluruh string.

pszWebViewTemplateVersion

Jenis: LPTSTR

Penunjuk ke buffer yang dihentikan null yang berisi versi templat WebView.

pszInfoTip

Jenis: LPTSTR

Penunjuk ke buffer yang dihentikan null yang berisi teks infotip folder.

cchInfoTip

Jenis: DWORD

Jika parameter SHGetSetFolderCustomSettingsdwReadWriteFCS_READ, ini adalah ukuran buffer pszInfoTip , dalam karakter. Jika tidak, ini adalah jumlah karakter yang akan ditulis dari buffer tersebut. Atur parameter ini ke 0 untuk menulis seluruh string.

pclsid

Jenis: CLSID*

Pointer ke CLSID yang digunakan untuk mengidentifikasi folder di registri Windows. Informasi folder lebih lanjut disimpan dalam registri di bawah entri CLSID tersebut.

dwFlags

Jenis: DWORD

Tidak digunakan.

pszIconFile

Jenis: LPTSTR

Penunjuk ke buffer yang dihentikan null yang berisi jalur ke file yang berisi ikon folder.

cchIconFile

Jenis: DWORD

Jika parameter SHGetSetFolderCustomSettingsdwReadWriteFCS_READ, ini adalah ukuran buffer pszIconFile , dalam karakter. Jika tidak, ini adalah jumlah karakter yang akan ditulis dari buffer tersebut. Atur parameter ini ke 0 untuk menulis seluruh string.

iIconIndex

Jenis: int

Indeks ikon dalam file bernama dalam pszIconFile.

pszLogo

Jenis: LPTSTR

Penunjuk ke buffer yang dihentikan null yang berisi jalur ke file yang berisi gambar logo folder. Ini adalah gambar yang digunakan dalam tampilan gambar mini.

cchLogo

Jenis: DWORD

Jika parameter SHGetSetFolderCustomSettingsdwReadWriteFCS_READ, ini adalah ukuran buffer pszLogo , dalam karakter. Jika tidak, ini adalah jumlah karakter yang akan ditulis dari buffer tersebut. Atur parameter ini ke 0 untuk menulis seluruh string.

Keterangan

Di Windows XP Service Pack 2 (SP2) dan versi yang lebih lama, struktur ini mendukung string ANSI dan Unicode. Di Windows Vista dan versi yang lebih baru, hanya string Unicode yang didukung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	shlobj_core.h (termasuk Shlobj.h)