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 の長さは、終端の null 文字を含め、MAX_PATH以下にする必要があります。

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 文字列の両方がサポートされています。

要件