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

指向以 null 结尾的字符串的指针，该字符串包含文件夹 的 WebView 模板的路径。

cchWebViewTemplate

类型：DWORD

如果 SHGetSetFolderCustomSettings 参数 dwReadWriteFCS_READ，则这是 pszWebViewTemplate 缓冲区的大小（以字符为单位）。 否则，这是要从该缓冲区写入的字符数。 将此参数设置为 0 可写入整个字符串。

pszWebViewTemplateVersion

类型： LPTSTR

指向包含 WebView 模板版本的以 null 结尾的缓冲区的指针。

pszInfoTip

类型： LPTSTR

指向以 null 结尾的缓冲区的指针，该缓冲区包含文件夹的信息提示的文本。

cchInfoTip

类型：DWORD

如果 SHGetSetFolderCustomSettings 参数 dwReadWriteFCS_READ，则这是 pszInfoTip 缓冲区的大小（以字符为单位）。 否则，这是要从该缓冲区写入的字符数。 将此参数设置为 0 可写入整个字符串。

pclsid

类型： CLSID*

指向 CLSID 的指针，用于标识 Windows 注册表中的文件夹。 其他文件夹信息存储在该 CLSID 条目下的注册表中。

dwFlags

类型：DWORD

未使用。

pszIconFile

类型： LPTSTR

指向以 null 结尾的缓冲区的指针，该缓冲区包含包含文件夹图标的文件的路径。

cchIconFile

类型：DWORD

如果 SHGetSetFolderCustomSettings 参数 dwReadWriteFCS_READ，则这是 pszIconFile 缓冲区的大小（以字符为单位）。 否则，这是要从该缓冲区写入的字符数。 将此参数设置为 0 可写入整个字符串。

iIconIndex

类型： int

pszIconFile 中名为 的文件中图标的索引。

pszLogo

类型： LPTSTR

指向以 null 结尾的缓冲区的指针，该缓冲区包含包含文件夹徽标图像的文件的路径。 这是缩略图视图中使用的图像。

cchLogo

类型：DWORD

如果 SHGetSetFolderCustomSettings 参数 dwReadWriteFCS_READ，则这是 pszLogo 缓冲区的大小（以字符为单位）。 否则，这是要从该缓冲区写入的字符数。 将此参数设置为 0 可写入整个字符串。

注解

在 Windows XP Service Pack 2 (SP2) 及更早版本中，此结构支持 ANSI 和 Unicode 字符串。 在 Windows Vista 及更高版本中，仅支持 Unicode 字符串。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	shlobj_core.h (包括 Shlobj.h)