SHGetSetSettings function (shlobj_core.h)

[SHGetSetSettings 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 Shell state settings.

Syntax

void SHGetSetSettings(
  [in, out] LPSHELLSTATE lpss,
  [in]      DWORD        dwMask,
  [in]      BOOL         bSet
);

Parameters

[in, out] lpss

Type: LPSHELLSTATE

A pointer to a SHELLSTATE structure that provides or receives the Shell state settings.

[in] dwMask

Type: DWORD

One or more of the SSF flags that indicate which settings should be set or retrieved.

[in] bSet

Type: BOOL

TRUE to indicate that the contents of lpss should be used to set the Shell settings, FALSE to indicate that the Shell settings should be retrieved to lpss.

Return value

None

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 5.0 or later)
API set ext-ms-win-shell-shell32-l1-2-2 (introduced in Windows 10, version 10.0.14393)

See also

SHGetSettings