Estrutura SHFOLDERCUSTOMSETTINGS (shlobj_core.h)

Contém configurações de pasta personalizadas. Essa estrutura é usada com a função SHGetSetFolderCustomSettings .

Sintaxe

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;

Membros

dwSize

Tipo: DWORD

O tamanho da estrutura em bytes.

dwMask

Tipo: DWORD

Um valor DWORD que especifica quais atributos de pasta ler ou gravar nessa estrutura. Use um ou mais dos seguintes valores para indicar quais membros da estrutura são válidos:

FCSM_VIEWID

Preterido. pvid contém o GUID da pasta.

FCSM_WEBVIEWTEMPLATE

Preterido. pszWebViewTemplate contém um ponteiro para um buffer que contém o caminho para o modelo WebView da pasta.

FCSM_INFOTIP

pszInfoTip contém um ponteiro para um buffer que contém a dica de informações da pasta.

FCSM_CLSID

pclsid contém o CLSID da pasta.

FCSM_ICONFILE

pszIconFile contém o caminho para o arquivo que contém o ícone da pasta.

FCSM_LOGO

pszLogo contém o caminho para o arquivo que contém o ícone de miniatura da pasta.

FCSM_FLAGS

Não usado.

pvid

Tipo: SHELLVIEWID*

O GUID da pasta.

pszWebViewTemplate

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho para o modelo WebView da pasta.

cchWebViewTemplate

Tipo: DWORD

Se o parâmetro SHGetSetFolderCustomSettingsdwReadWrite for FCS_READ, esse será o tamanho do buffer pszWebViewTemplate , em caracteres. Caso contrário, esse é o número de caracteres a serem gravados desse buffer. Defina esse parâmetro como 0 para gravar a cadeia de caracteres inteira.

pszWebViewTemplateVersion

Tipo: LPTSTR

Um ponteiro para um buffer terminado em nulo que contém a versão do modelo do WebView.

pszInfoTip

Tipo: LPTSTR

Um ponteiro para um buffer terminado em nulo que contém o texto da dica de informações da pasta.

cchInfoTip

Tipo: DWORD

Se o parâmetro SHGetSetFolderCustomSettingsdwReadWrite for FCS_READ, esse será o tamanho do buffer pszInfoTip, em caracteres . Caso contrário, esse é o número de caracteres a serem gravados desse buffer. Defina esse parâmetro como 0 para gravar a cadeia de caracteres inteira.

pclsid

Tipo: CLSID*

Um ponteiro para um CLSID usado para identificar a pasta no Registro do Windows. Outras informações de pasta são armazenadas no registro sob essa entrada CLSID.

dwFlags

Tipo: DWORD

Não usado.

pszIconFile

Tipo: LPTSTR

Um ponteiro para um buffer terminado em nulo que contém o caminho para o arquivo que contém o ícone da pasta.

cchIconFile

Tipo: DWORD

Se o parâmetro SHGetSetFolderCustomSettingsdwReadWrite for FCS_READ, esse será o tamanho do buffer pszIconFile, em caracteres . Caso contrário, esse é o número de caracteres a serem gravados desse buffer. Defina esse parâmetro como 0 para gravar a cadeia de caracteres inteira.

iIconIndex

Tipo: int

O índice do ícone dentro do arquivo chamado em pszIconFile.

pszLogo

Tipo: LPTSTR

Um ponteiro para um buffer terminado em nulo que contém o caminho para o arquivo que contém a imagem do logotipo da pasta. Esta é a imagem usada em modos de exibição em miniatura.

cchLogo

Tipo: DWORD

Se o parâmetro SHGetSetFolderCustomSettingsdwReadWrite for FCS_READ, esse será o tamanho do buffer pszLogo, em caracteres . Caso contrário, esse é o número de caracteres a serem gravados desse buffer. Defina esse parâmetro como 0 para gravar a cadeia de caracteres inteira.

Comentários

No Windows XP Service Pack 2 (SP2) e em versões anteriores, essa estrutura suportava cadeias de caracteres ANSI e Unicode. No Windows Vista e em versões posteriores, há suporte apenas para cadeias de caracteres Unicode.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	shlobj_core.h (inclua Shlobj.h)