.. highlightlang:: us

.. index:: Shell_GetSpecialFolder

.. _shell_getspecialfolder:

Shell_GetSpecialFolder
======================

.. us.tag  Shell_GetSpecialFolder NOTREADYENGLISH FILE_MISC New530

:ref:`Shell_GetSpecialFolder` returns the path for a given ID. For example 
CSIDL_DESKTOPDIRECTORY returns the desktop directory for the current user.

.. function::  ssSpecialFolder = Shell_GetSpecialFolder(nFolder)

.. us.return

**Return Value**

*ssSpecialFolder* is the directory for the short cut.

.. us.params

**Parameters**

.. uparam:: nFolder

   *nFolder* is one of the following IDs. More in the Windows SDK.

.. list-table::
   :header-rows: 0

   * - CSIDL_DESKTOP
     - 0x0000
     - // <desktop>
   * - CSIDL_PROGRAMS
     - 0x0002
     - // Start Menu\\Programs
   * - CSIDL_PERSONAL
     - 0x0005
     - // My Documents
   * - CSIDL_FAVORITES
     - 0x0006
     - // <user name>\\Favorites
   * - CSIDL_STARTUP
     - 0x0007
     - // Start Menu\\Programs\\Startup
   * - CSIDL_RECENT
     - 0x0008
     - // <user name>\\Recent
   * - CSIDL_SENDTO
     - 0x0009
     - // <user name>\\SendTo
   * - CSIDL_STARTMENU
     - 0x000b
     - // <user name>\\Start Menu
   * - CSIDL_DESKTOPDIRECTORY
     - 0x0010
     - // <user name>\\Desktop
   * - CSIDL_COMMON_STARTMENU
     - 0x0016
     - // All Users\\Start Menu
   * - CSIDL_COMMON_PROGRAMS
     - 0X0017
     - // All Users\\Start Menu\\Programs
   * - CSIDL_COMMON_STARTUP
     - 0x0018
     - // All Users\\Startup
   * - CSIDL_COMMON_DESKTOPDIRECTORY
     - 0x0019
     - // All Users\\Desktop

.. us.example

**Example**

See :ref:`Shell_CreateShortcut`.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.3.0
     - New.

.. seealso::
   :ref:`overview-files`,
   :ref:`Shell_CreateShortcut`

:sub:`id-1820796`