Funzione SHGetSetFolderCustomSettings (shlobj_core.h)

  • Articolo

[SHGetSetFolderCustomSettings è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Imposta o recupera le impostazioni delle cartelle personalizzate. Questa funzione legge da e scrive in Desktop.ini.

Sintassi

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

Parametri

[in, out] pfcs

Tipo: LPSHFOLDERCUSTOMSETTINGS

Puntatore a una struttura SHFOLDERCUSTOMSETTINGS che fornisce o riceve le impostazioni delle cartelle personalizzate.

[in] pszPath

Tipo: PCTSTR

Puntatore a una stringa Unicode con terminazione null contenente il percorso della cartella. La lunghezza di pszPath deve essere MAX_PATH o minore, incluso il carattere null terminante.

dwReadWrite

Tipo: DWORD

Flag che controlla l'azione della funzione. Può trattarsi di uno dei valori seguenti.

FCS_READ (0x00000001)

Recuperare le impostazioni delle cartelle personalizzate nei pfcs.

FCS_FORCEWRITE (0x00000002)

Usare pfcs per impostare le impostazioni della cartella personalizzata indipendentemente dal fatto che i valori siano già presenti.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Usare pfcs per impostare le impostazioni della cartella personalizzata se i valori non sono già presenti.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Sono supportate solo le stringhe Unicode.

Windows Server 2003 e Windows XP: SHGetSetFolderCustomSettings supporta stringhe ANSI e Unicode.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (include Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 6.0 o successiva)