Función SHGetSpecialFolderLocation (shlobj_core.h)
[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) |