Structure SHFOLDERCUSTOMSETTINGS (shlobj_core.h)

Contient les paramètres de dossier personnalisés. Cette structure est utilisée avec la fonction SHGetSetFolderCustomSettings .

Syntaxe

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;

Membres

dwSize

Type : DWORD

Taille de la structure, en octets.

dwMask

Type : DWORD

Valeur DWORD spécifiant les attributs de dossier à lire ou écrire à partir de cette structure. Utilisez une ou plusieurs des valeurs suivantes pour indiquer quels membres de structure sont valides :

FCSM_VIEWID

Déconseillé. pvid contient le GUID du dossier.

FCSM_WEBVIEWTEMPLATE

Déconseillé. pszWebViewTemplate contient un pointeur vers une mémoire tampon contenant le chemin d’accès au modèle WebView du dossier.

FCSM_INFOTIP

pszInfoTip contient un pointeur vers une mémoire tampon contenant l’info-bulle du dossier.

FCSM_CLSID

pclsid contient le CLSID du dossier.

FCSM_ICONFILE

pszIconFile contient le chemin d’accès au fichier contenant l’icône du dossier.

FCSM_LOGO

pszLogo contient le chemin d’accès au fichier contenant l’icône miniature du dossier.

FCSM_FLAGS

Non utilisé.

pvid

Type : SHELLVIEWID*

GUID du dossier.

pszWebViewTemplate

Type : LPTSTR

Pointeur vers une chaîne terminée par null contenant le chemin d’accès au modèle WebView du dossier.

cchWebViewTemplate

Type : DWORD

Si le paramètre SHGetSetFolderCustomSettingsdwReadWrite est FCS_READ, il s’agit de la taille de la mémoire tampon pszWebViewTemplate , en caractères. Si ce n’est pas le cas, il s’agit du nombre de caractères à écrire à partir de cette mémoire tampon. Définissez ce paramètre sur 0 pour écrire la chaîne entière.

pszWebViewTemplateVersion

Type : LPTSTR

Pointeur vers une mémoire tampon terminée par null contenant la version du modèle WebView.

pszInfoTip

Type : LPTSTR

Pointeur vers une mémoire tampon terminée par null contenant le texte de l’info-bulle du dossier.

cchInfoTip

Type : DWORD

Si le paramètre SHGetSetFolderCustomSettingsdwReadWrite est FCS_READ, il s’agit de la taille de la mémoire tampon pszInfoTip , en caractères. Si ce n’est pas le cas, il s’agit du nombre de caractères à écrire à partir de cette mémoire tampon. Définissez ce paramètre sur 0 pour écrire la chaîne entière.

pclsid

Type : CLSID*

Pointeur vers un CLSID utilisé pour identifier le dossier dans le Registre Windows. D’autres informations de dossier sont stockées dans le Registre sous cette entrée CLSID.

dwFlags

Type : DWORD

Non utilisé.

pszIconFile

Type : LPTSTR

Pointeur vers une mémoire tampon terminée par null contenant le chemin d’accès au fichier contenant l’icône du dossier.

cchIconFile

Type : DWORD

Si le paramètre SHGetSetFolderCustomSettingsdwReadWrite est FCS_READ, il s’agit de la taille de la mémoire tampon pszIconFile , en caractères. Si ce n’est pas le cas, il s’agit du nombre de caractères à écrire à partir de cette mémoire tampon. Définissez ce paramètre sur 0 pour écrire la chaîne entière.

iIconIndex

Type : int

Index de l’icône dans le fichier nommé dans pszIconFile.

pszLogo

Type : LPTSTR

Pointeur vers une mémoire tampon terminée par null contenant le chemin d’accès au fichier contenant l’image de logo du dossier. Il s’agit de l’image utilisée dans les vues miniatures.

cchLogo

Type : DWORD

Si le paramètre SHGetSetFolderCustomSettingsdwReadWrite est FCS_READ, il s’agit de la taille de la mémoire tampon pszLogo , en caractères. Si ce n’est pas le cas, il s’agit du nombre de caractères à écrire à partir de cette mémoire tampon. Définissez ce paramètre sur 0 pour écrire la chaîne entière.

Remarques

Dans Windows XP Service Pack 2 (SP2) et les versions antérieures, cette structure a pris en charge les chaînes ANSI et Unicode. Dans Windows Vista et les versions ultérieures, seules les chaînes Unicode sont prises en charge.

Configuration requise