###User Defined Function###
_WinAPI_ShellGetKnownFolderIDList

###Description###
Retrieves the path of a known folder as an ITEMIDLIST structure.

###Syntax###
#include <WinAPIShPath.au3>
_WinAPI_ShellGetKnownFolderIDList ( $GUID [, $iFlags = 0 [, $hToken = 0]] )


###Parameters###
@@ParamTable@@
$GUID
	The GUID ($FOLDERID_*) that identifies the standard folders registered with the system.
$iFlags
	[optional] The flags that specify special retrieval options. This parameter can be one or more of the following values.
	$KF_FLAG_CREATE
	$KF_FLAG_DONT_VERIFY
	$KF_FLAG_DONT_UNEXPAND
	$KF_FLAG_NO_ALIAS
	$KF_FLAG_INIT
	$KF_FLAG_DEFAULT_PATH
	$KF_FLAG_NOT_PARENT_RELATIVE
	$KF_FLAG_SIMPLE_IDLIST

	Windows 7 or later
	$KF_FLAG_ALIAS_ONLY
$hToken
	[optional] The access token that represents a particular user. If this parameter is 0, the function requests
	the known folder for the current user. Assigning the $hToken parameter a value of (-1) indicates the
	Default User. Note that access to the Default User folders requires administrator privileges.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success 	The PIDL of the folder.
Failure 	0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.
@@End@@


###Remarks###
To free the returned PIDL, call the <a href="_WinAPI_CoTaskMemFree.htm">_WinAPI_CoTaskMemFree()</a> function.

This function requires <strong>Windows Vista or later</strong>.


###Related###
_WinAPI_CoTaskMemFree


###See Also###
@@MsdnLink@@ SHGetKnownFolderIDList
