Estructura SHFOLDERCUSTOMSETTINGS (shlobj_core.h)

Contiene la configuración de carpeta personalizada. Esta estructura se usa con la función SHGetSetFolderCustomSettings .

Sintaxis

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;

Miembros

dwSize

Tipo: DWORD

El tamaño de la estructura en bytes.

dwMask

Tipo: DWORD

Valor DWORD que especifica qué atributos de carpeta se van a leer o escribir de esta estructura. Use uno o varios de los valores siguientes para indicar qué miembros de estructura son válidos:

FCSM_VIEWID

En desuso. pvid contiene el GUID de la carpeta.

FCSM_WEBVIEWTEMPLATE

En desuso. pszWebViewTemplate contiene un puntero a un búfer que contiene la ruta de acceso a la plantilla WebView de la carpeta.

FCSM_INFOTIP

pszInfoTip contiene un puntero a un búfer que contiene la información de la carpeta.

FCSM_CLSID

pclsid contiene el CLSID de la carpeta.

FCSM_ICONFILE

pszIconFile contiene la ruta de acceso al archivo que contiene el icono de la carpeta.

FCSM_LOGO

pszLogo contiene la ruta de acceso al archivo que contiene el icono de miniatura de la carpeta.

FCSM_FLAGS

No se usa.

pvid

Tipo: SHELLVIEWID*

GUID de la carpeta.

pszWebViewTemplate

Tipo: LPTSTR

Puntero a una cadena terminada en null que contiene la ruta de acceso a la plantilla WebView de la carpeta.

cchWebViewTemplate

Tipo: DWORD

Si el parámetro SHGetSetFolderCustomSettingsdwReadWrite es FCS_READ, este es el tamaño del búfer pszWebViewTemplate , en caracteres. Si no es así, este es el número de caracteres que se van a escribir desde ese búfer. Establezca este parámetro en 0 para escribir toda la cadena.

pszWebViewTemplateVersion

Tipo: LPTSTR

Puntero a un búfer terminado en null que contiene la versión de plantilla de WebView.

pszInfoTip

Tipo: LPTSTR

Puntero a un búfer terminado en null que contiene el texto de la información sobre la carpeta.

cchInfoTip

Tipo: DWORD

Si el parámetro SHGetSetFolderCustomSettingsdwReadWrite es FCS_READ, este es el tamaño del búfer pszInfoTip , en caracteres. Si no es así, este es el número de caracteres que se van a escribir desde ese búfer. Establezca este parámetro en 0 para escribir toda la cadena.

pclsid

Tipo: CLSID*

Puntero a un CLSID que se usa para identificar la carpeta en el Registro de Windows. La información adicional de carpeta se almacena en el Registro en esa entrada CLSID.

dwFlags

Tipo: DWORD

No se usa.

pszIconFile

Tipo: LPTSTR

Puntero a un búfer terminado en null que contiene la ruta de acceso al archivo que contiene el icono de la carpeta.

cchIconFile

Tipo: DWORD

Si el parámetro SHGetSetFolderCustomSettingsdwReadWrite es FCS_READ, este es el tamaño del búfer pszIconFile , en caracteres. Si no es así, este es el número de caracteres que se van a escribir desde ese búfer. Establezca este parámetro en 0 para escribir toda la cadena.

iIconIndex

Tipo: int

Índice del icono dentro del archivo denominado en pszIconFile.

pszLogo

Tipo: LPTSTR

Puntero a un búfer terminado en null que contiene la ruta de acceso al archivo que contiene la imagen del logotipo de la carpeta. Esta es la imagen usada en vistas en miniatura.

cchLogo

Tipo: DWORD

Si el parámetro SHGetSetFolderCustomSettingsdwReadWrite es FCS_READ, este es el tamaño del búfer pszLogo , en caracteres. Si no es así, este es el número de caracteres que se van a escribir desde ese búfer. Establezca este parámetro en 0 para escribir toda la cadena.

Comentarios

En Windows XP Service Pack 2 (SP2) y versiones anteriores, esta estructura admite cadenas ANSI y Unicode. En Windows Vista y versiones posteriores, solo se admiten cadenas Unicode.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	shlobj_core.h (incluya Shlobj.h)