Fonction SHGetSetFolderCustomSettings (shlobj_core.h)

[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