Функция SHGetSetFolderCustomSettings (shlobj_core.h)

Статья
03/05/2024

[SHGetSetFolderCustomSettings доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Задает или извлекает пользовательские параметры папки. Эта функция считывает и записывает данные в Desktop.ini.

Синтаксис

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

Параметры

[in, out] pfcs

Тип: LPSHFOLDERCUSTOMSETTINGS

Указатель на структуру SHFOLDERCUSTOMSETTINGS , которая предоставляет или получает пользовательские параметры папки.

[in] pszPath

Тип: PCTSTR

Указатель на строку Юникода с пустым завершением, содержащую путь к папке. Длина pszPath должна быть MAX_PATH или меньше, включая завершающий символ NULL.

dwReadWrite

Тип: DWORD

Флаг, который управляет действием функции. Это может быть одно из следующих значений.

FCS_READ (0x00000001)

Получение параметров пользовательских папок в pfcs.

FCS_FORCEWRITE (0x00000002)

Используйте pfcs , чтобы задать параметры пользовательской папки независимо от того, существуют ли уже значения.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Используйте pfcs , чтобы задать параметры пользовательской папки, если значения еще отсутствуют.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 6.0 или более поздняя)

Поделиться через