Struttura SHFOLDERCUSTOMSETTINGS (shlobj_core.h)

Contiene le impostazioni delle cartelle personalizzate. Questa struttura viene usata con la funzione SHGetSetFolderCustomSettings .

Sintassi

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;

Members

dwSize

Tipo: DWORD

Dimensioni della struttura, in byte.

dwMask

Tipo: DWORD

Valore DWORD che specifica gli attributi della cartella da leggere o scrivere da questa struttura. Usare uno o più dei valori seguenti per indicare quali membri della struttura sono validi:

FCSM_VIEWID

Deprecato. pvid contiene il GUID della cartella.

FCSM_WEBVIEWTEMPLATE

Deprecato. pszWebViewTemplate contiene un puntatore a un buffer contenente il percorso del modello WebView della cartella.

FCSM_INFOTIP

pszInfoTip contiene un puntatore a un buffer contenente la descrizione informativa della cartella.

FCSM_CLSID

pclsid contiene il CLSID della cartella.

FCSM_ICONFILE

pszIconFile contiene il percorso del file contenente l'icona della cartella.

FCSM_LOGO

pszLogo contiene il percorso del file contenente l'icona di anteprima della cartella.

FCSM_FLAGS

Non usato.

pvid

Tipo: SHELLVIEWID*

GUID della cartella.

pszWebViewTemplate

Tipo: LPTSTR

Puntatore a una stringa con terminazione Null contenente il percorso del modello WebView della cartella.

cchWebViewTemplate

Tipo: DWORD

Se il parametro SHGetSetFolderCustomSettingsdwReadWrite è FCS_READ, si tratta delle dimensioni del buffer pszWebViewTemplate , espresso in caratteri. In caso contrario, questo è il numero di caratteri da scrivere da tale buffer. Impostare questo parametro su 0 per scrivere l'intera stringa.

pszWebViewTemplateVersion

Tipo: LPTSTR

Puntatore a un buffer con terminazione Null contenente la versione del modello WebView.

pszInfoTip

Tipo: LPTSTR

Puntatore a un buffer con terminazione Null contenente il testo della descrizione info della cartella.

cchInfoTip

Tipo: DWORD

Se il parametro SHGetSetFolderCustomSettingsdwReadWrite è FCS_READ, si tratta delle dimensioni del buffer pszInfoTip , in caratteri. In caso contrario, questo è il numero di caratteri da scrivere da tale buffer. Impostare questo parametro su 0 per scrivere l'intera stringa.

pclsid

Tipo: CLSID*

Puntatore a un CLSID utilizzato per identificare la cartella nel Registro di sistema di Windows. Altre informazioni sulla cartella vengono archiviate nel Registro di sistema in tale voce CLSID.

dwFlags

Tipo: DWORD

Non usato.

pszIconFile

Tipo: LPTSTR

Puntatore a un buffer con terminazione Null contenente il percorso del file contenente l'icona della cartella.

cchIconFile

Tipo: DWORD

Se il parametro SHGetSetFolderCustomSettingsdwReadWrite è FCS_READ, si tratta delle dimensioni del buffer pszIconFile , in caratteri. In caso contrario, questo è il numero di caratteri da scrivere da tale buffer. Impostare questo parametro su 0 per scrivere l'intera stringa.

iIconIndex

Tipo: int

Indice dell'icona all'interno del file denominato in pszIconFile.

pszLogo

Tipo: LPTSTR

Puntatore a un buffer con terminazione Null contenente il percorso del file contenente l'immagine del logo della cartella. Questa è l'immagine usata nelle visualizzazioni di anteprima.

cchLogo

Tipo: DWORD

Se il parametro SHGetSetFolderCustomSettingsdwReadWrite è FCS_READ, si tratta delle dimensioni del buffer pszLogo , espresso in caratteri. In caso contrario, questo è il numero di caratteri da scrivere da tale buffer. Impostare questo parametro su 0 per scrivere l'intera stringa.

Commenti

In Windows XP Service Pack 2 (SP2) e versioni precedenti, questa struttura supporta le stringhe ANSI e Unicode. In Windows Vista e versioni successive sono supportate solo le stringhe Unicode.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	shlobj_core.h (includere Shlobj.h)