# Function Reference

# _WinAPI_ShellGetSpecialFolderLocation

Retrieves a pointer to the ITEMIDLIST structure (PIDL) of a special folder

#include <WinAPIShellEx.au3>
_WinAPI_ShellGetSpecialFolderLocation ( $iCSIDL )

## Parameters

$iCSIDL | The CSIDL ($CSIDL_*) that identifies the folder of interest.

## Return Value

Success: | The PIDL specifying the folder's location relative to the root of the namespace (the desktop).
Failure: | 0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.

## Remarks

To free the returned PIDL, call the _WinAPI_CoTaskMemFree() function.

## See Also

Search SHGetSpecialFolderLocation in MSDN Library.