Función SHGetSpecialFolderLocation (shlobj_core.h)

Artículo
03/13/2024

[SHGetSpecialFolderLocation no se admite y puede modificarse o no estar disponible en el futuro. En su lugar, use SHGetFolderLocation.]

Recupera un puntero a la estructura ITEMIDLIST de una carpeta especial.

Sintaxis

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parámetros

[in] hwnd

Tipo: HWND

Reservado.

[in] csidl

Tipo: int

Valor CSIDL que identifica la carpeta de interés.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

PIDL que especifica la ubicación de la carpeta en relación con la raíz del espacio de nombres (el escritorio). Es responsabilidad de la aplicación que realiza la llamada liberar el IDList devuelto mediante CoTaskMemFree.

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.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 4.0 o posterior)
Conjunto de API	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

SHGetSpecialFolderPath