共用方式為

SHGetSetFolderCustomSettings 函式 (shlobj_core.h)

  • 發行項

[SHGetSetFolderCustomSettings 可用於需求一節中指定的操作系統。 它可能會在後續版本中改變或無法使用。]

設定或擷取自訂資料夾設定。 此函式會讀取 和寫入至 Desktop.ini。

語法

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

參數

[in, out] pfcs

類型： LPSHFOLDERCUSTOMSETTINGS

SHFOLDERCUSTOMSETTINGS 結構的指標，提供或接收自定義資料夾設定。

[in] pszPath

類型： PCTSTR

包含資料夾路徑之 Null 終止 Unicode 字串的指標。 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 錯誤碼。

備註

僅支援 Unicode 字串。

Windows Server 2003 和 Windows XP： SHGetSetFolderCustomSettings 同時支援 ANSI 和 Unicode 字符串。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.0 版或更新版本)