Структура 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

Если параметру DWReadWriteдля SHGetSetFolderCustomSettingsFCS_READ, это размер буфера pszWebViewTemplate в символах. В противном случае это число символов для записи из этого буфера. Задайте для этого параметра значение 0, чтобы записать всю строку.

pszWebViewTemplateVersion

Тип: LPTSTR

Указатель на буфер с завершением null, содержащий версию шаблона WebView.

pszInfoTip

Тип: LPTSTR

Указатель на буфер с завершением NULL, содержащий текст подсказки папки.

cchInfoTip

Тип: DWORD

Если параметру DWReadWriteдля SHGetSetFolderCustomSettingsFCS_READ, это размер буфера pszInfoTip в символах. В противном случае это число символов для записи из этого буфера. Задайте для этого параметра значение 0, чтобы записать всю строку.

pclsid

Тип: CLSID*

Указатель на ИДЕНТИФИКАТОР CLSID, используемый для идентификации папки в реестре Windows. Дополнительные сведения о папке хранятся в реестре в этой записи CLSID.

dwFlags

Тип: DWORD

Не используется.

pszIconFile

Тип: LPTSTR

Указатель на буфер с завершением null, содержащий путь к файлу со значком папки.

cchIconFile

Тип: DWORD

Если параметру DWReadWriteдля SHGetSetFolderCustomSettingsFCS_READ, это размер буфера pszIconFile в символах. В противном случае это число символов для записи из этого буфера. Задайте для этого параметра значение 0, чтобы записать всю строку.

iIconIndex

Тип: int

Индекс значка в файле с именем в pszIconFile.

pszLogo

Тип: LPTSTR

Указатель на буфер с пустым завершением, содержащий путь к файлу с изображением логотипа папки. Это изображение, используемое в представлениях эскизов.

cchLogo

Тип: DWORD

Если параметр DWReadWriteSHGetSetFolderCustomSettingsFCS_READ, это размер буфера pszLogo в символах. В противном случае это число символов для записи из этого буфера. Задайте для этого параметра значение 0, чтобы записать всю строку.

Комментарии

В Windows XP с пакетом обновления 2 (SP2) и более ранних версиях эта структура поддерживала строки ANSI и Юникода. В Windows Vista и более поздних версиях поддерживаются только строки Юникода.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	shlobj_core.h (включая Shlobj.h)