SHGetSetFolderCustomSettings function (shlobj_core.h)

[SHGetSetFolderCustomSettings is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Sets or retrieves custom folder settings. This function reads from and writes to Desktop.ini.

Syntax

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

Parameters

[in, out] pfcs

Type: LPSHFOLDERCUSTOMSETTINGS

A pointer to a SHFOLDERCUSTOMSETTINGS structure that provides or receives the custom folder settings.

[in] pszPath

Type: PCTSTR

A pointer to a null-terminated Unicode string that contains the path to the folder. The length of pszPath must be MAX_PATH or less, including the terminating null character.

dwReadWrite

Type: DWORD

A flag that controls the action of the function. It may be one of the following values.

FCS_READ (0x00000001)

Retrieve the custom folder settings in pfcs.

FCS_FORCEWRITE (0x00000002)

Use pfcs to set the custom folder's settings regardless of whether the values are already present.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Use pfcs to set the custom folder's settings if the values are not already present.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Only Unicode strings are supported.

Windows Server 2003 and Windows XP:  SHGetSetFolderCustomSettings supports both ANSI and Unicode strings.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 6.0 or later)