Compartir a través de

Función SHGetSetFolderCustomSettings (shlobj_core.h)

  • Artículo

[SHGetSetFolderCustomSettings está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Establece o recupera la configuración de carpeta personalizada. Esta función lee y escribe en Desktop.ini.

Sintaxis

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

Parámetros

[in, out] pfcs

Tipo: LPSHFOLDERCUSTOMSETTINGS

Puntero a una estructura SHFOLDERCUSTOMSETTINGS que proporciona o recibe la configuración de carpeta personalizada.

[in] pszPath

Tipo: PCTSTR

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso a la carpeta. La longitud de pszPath debe ser MAX_PATH o menos, incluido el carácter nulo de terminación.

dwReadWrite

Tipo: DWORD

Marca que controla la acción de la función. Puede ser uno de los siguientes valores.

FCS_READ (0x00000001)

Recupere la configuración de carpeta personalizada en pfcs.

FCS_FORCEWRITE (0x00000002)

Use pfcs para establecer la configuración de la carpeta personalizada independientemente de si los valores ya están presentes.

FCS_WRITE (FCS_READ | FCS_FORCEWRITE)

Use pfcs para establecer la configuración de la carpeta personalizada si los valores aún no están presentes.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Solo se admiten cadenas Unicode.

Windows Server 2003 y Windows XP: SHGetSetFolderCustomSettings admite cadenas ANSI y Unicode.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.0 o posterior)