SHGetSetFolderCustomSettings-Funktion (shlobj_core.h)

  • Artikel

[SHGetSetFolderCustomSettings ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Legt benutzerdefinierte Ordnereinstellungen fest oder ruft sie ab. Diese Funktion liest aus und schreibt in Desktop.ini.

Syntax

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

Parameter

[in, out] pfcs

Typ: LPSHFOLDERCUSTOMSETTINGS

Ein Zeiger auf eine SHFOLDERCUSTOMSETTINGS-Struktur , die die benutzerdefinierten Ordnereinstellungen bereitstellt oder empfängt.

[in] pszPath

Typ: PCTSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad zum Ordner enthält. Die Länge von pszPath muss MAX_PATH oder kleiner sein, einschließlich des beendenden NULL-Zeichens.

dwReadWrite

Art: DWORD

Ein Flag, das die Aktion der Funktion steuert. Es kann sich um einen der folgenden Werte handeln.

FCS_READ (0x00000001)

Rufen Sie die benutzerdefinierten Ordnereinstellungen in pfcs ab.

FCS_FORCEWRITE (0x00000002)

Verwenden Sie pfcs , um die Einstellungen des benutzerdefinierten Ordners festzulegen, unabhängig davon, ob die Werte bereits vorhanden sind.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Verwenden Sie pfcs , um die Einstellungen des benutzerdefinierten Ordners festzulegen, wenn die Werte noch nicht vorhanden sind.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Es werden nur Unicode-Zeichenfolgen unterstützt.

Windows Server 2003 und Windows XP: SHGetSetFolderCustomSettings unterstützt sowohl ANSI- als auch Unicode-Zeichenfolgen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.0 oder höher)