Função SHGetSetFolderCustomSettings (shlobj_core.h)

[SHGetSetFolderCustomSettings está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Define ou recupera configurações de pasta personalizadas. Essa função lê e grava em Desktop.ini.

Sintaxe

SHSTDAPI SHGetSetFolderCustomSettings(
  [in, out] LPSHFOLDERCUSTOMSETTINGS pfcs,
  [in]      PCWSTR                   pszPath,
            DWORD                    dwReadWrite
);

Parâmetros

[in, out] pfcs

Tipo: LPSHFOLDERCUSTOMSETTINGS

Um ponteiro para uma estrutura SHFOLDERCUSTOMSETTINGS que fornece ou recebe as configurações de pasta personalizadas.

[in] pszPath

Tipo: PCTSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho para a pasta. O comprimento do pszPath deve ser MAX_PATH ou menos, incluindo o caractere nulo de terminação.

dwReadWrite

Tipo: DWORD

Um sinalizador que controla a ação da função. Pode ser um dos valores a seguir.

FCS_READ (0x00000001)

Recupere as configurações de pasta personalizadas em pfcs.

FCS_FORCEWRITE (0x00000002)

Use pfcs para definir as configurações da pasta personalizada, independentemente de os valores já estarem presentes.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Use pfcs para definir as configurações da pasta personalizada se os valores ainda não estiverem presentes.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Há suporte apenas para cadeias de caracteres Unicode.

Windows Server 2003 e Windows XP: SHGetSetFolderCustomSettings dá suporte a cadeias de caracteres ANSI e 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]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 6.0 ou posterior)