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.
SHSTDAPI SHGetSetFolderCustomSettings(
[in, out] LPSHFOLDERCUSTOMSETTINGS pfcs,
[in] PCWSTR pszPath,
DWORD dwReadWrite
);
[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.
Recupere as configurações de pasta personalizadas em pfcs.
Use pfcs para definir as configurações da pasta personalizada, independentemente de os valores já estarem presentes.
Use pfcs para definir as configurações da pasta personalizada se os valores ainda não estiverem presentes.
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Há suporte apenas para cadeias de caracteres Unicode.
Windows Server 2003 e Windows XP: SHGetSetFolderCustomSettings dá suporte a cadeias de caracteres ANSI e Unicode.
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) |