SHFOLDERCUSTOMSETTINGS 結構 (shlobj_core.h)

保留自訂資料夾設定。 此結構會與 SHGetSetFolderCustomSettings 函式搭配使用。

語法

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;

成員

dwSize

類型： DWORD

結構的大小，以位元組為單位。

dwMask

類型： DWORD

DWORD 值，指定要從這個結構讀取或寫入的資料夾屬性。 使用下列一或多個值來指出哪些結構成員有效：

FCSM_VIEWID

已被取代。 pvid 包含資料夾的 GUID。

FCSM_WEBVIEWTEMPLATE

已被取代。 pszWebViewTemplate 包含緩衝區的指標，其中包含資料夾 WebView 範本的路徑。

FCSM_INFOTIP

pszInfoTip 包含緩衝區的指標，其中包含資料夾的資訊提示。

FCSM_CLSID

pclsid 包含資料夾的 CLSID。

FCSM_ICONFILE

pszIconFile 包含包含資料夾圖示之檔案的路徑。

FCSM_LOGO

pszLogo 包含包含資料夾縮圖圖示之檔案的路徑。

FCSM_FLAGS

未使用。

pvid

類型： SHELLVIEWID*

資料夾的 GUID。

pszWebViewTemplate

類型： LPTSTR

包含資料夾 WebView 樣本路徑之 Null 終止字串的指標。

cchWebViewTemplate

類型： DWORD

如果 SHGetSetFolderCustomSettings 參數 dwReadWrite是FCS_READ，則這是 pszWebViewTemplate 緩衝區的大小，以字元為單位。 如果沒有，這是要從該緩衝區寫入的字元數。 將此參數設定為 0 以寫入整個字串。

pszWebViewTemplateVersion

類型： LPTSTR

包含 WebView 範本版本的 Null 終止緩衝區指標。

pszInfoTip

類型： LPTSTR

Null 終止緩衝區的指標，其中包含資料夾資訊提示的文字。

cchInfoTip

類型： DWORD

如果 SHGetSetFolderCustomSettings 參數 dwReadWrite是FCS_READ，則這是 pszInfoTip 緩衝區的大小，以字元為單位。 如果沒有，這是要從該緩衝區寫入的字元數。 將此參數設定為 0 以寫入整個字串。

pclsid

類型： CLSID*

用來識別 Windows 登錄中資料夾之 CLSID 的指標。 進一步的資料夾資訊會儲存在該 CLSID 專案下的登錄中。

dwFlags

類型： DWORD

未使用。

pszIconFile

類型： LPTSTR

Null 終止緩衝區的指標，其中包含包含資料夾圖示之檔案的路徑。

cchIconFile

類型： DWORD

如果 SHGetSetFolderCustomSettings 參數 dwReadWrite是FCS_READ，則這是 pszIconFile 緩衝區的大小，以字元為單位。 如果沒有，這是要從該緩衝區寫入的字元數。 將此參數設定為 0 以寫入整個字串。

iIconIndex

類型： int

pszIconFile 中名為 的檔案中圖標的索引。

pszLogo

類型： LPTSTR

Null 終止緩衝區的指標，其中包含包含資料夾標誌影像之檔案的路徑。 這是縮圖檢視中使用的影像。

cchLogo

類型： DWORD

如果 SHGetSetFolderCustomSettings 參數 dwReadWrite是FCS_READ，則這是 pszLogo 緩衝區的大小，以字元為單位。 如果沒有，這是要從該緩衝區寫入的字元數。 將此參數設定為 0 以寫入整個字串。

備註

在 Windows XP Service Pack 2 (SP2) 和舊版中，此結構同時支援 ANSI 和 Unicode 字串。 在 Windows Vista 和更新版本中，僅支援 Unicode 字串。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	shlobj_core.h (包含 Shlobj.h)