Fonction SHGetSetFolderCustomSettings (shlobj_core.h)

Article
03/04/2024

[SHGetSetFolderCustomSettings est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Définit ou récupère les paramètres de dossier personnalisés. Cette fonction lit et écrit dans Desktop.ini.

Syntaxe

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

Paramètres

[in, out] pfcs

Type : LPSHFOLDERCUSTOMSETTINGS

Pointeur vers une structure SHFOLDERCUSTOMSETTINGS qui fournit ou reçoit les paramètres de dossier personnalisé.

[in] pszPath

Type : PCTSTR

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le chemin d’accès au dossier. La longueur de pszPath doit être MAX_PATH ou inférieure, y compris le caractère null de fin.

dwReadWrite

Type : DWORD

Indicateur qui contrôle l’action de la fonction. Il peut s’agir de l’une des valeurs suivantes.

FCS_READ (0x00000001)

Récupérez les paramètres de dossier personnalisé dans pfcs.

FCS_FORCEWRITE (0x00000002)

Utilisez pfcs pour définir les paramètres du dossier personnalisé, que les valeurs soient déjà présentes ou non.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Utilisez pfcs pour définir les paramètres du dossier personnalisé si les valeurs ne sont pas déjà présentes.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Seules les chaînes Unicode sont prises en charge.

Windows Server 2003 et Windows XP : SHGetSetFolderCustomSettings prend en charge les chaînes ANSI et Unicode.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.0 ou ultérieure)

Partager via