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) |
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για