# Function Reference

# _WinAPI_ShellSetKnownFolderPath

Redirects a known folder to a new location

#include <WinAPIShellEx.au3>
_WinAPI_ShellSetKnownFolderPath ( $sGUID, $sFilePath [, $iFlags = 0 [, $hToken = 0]] )

## Parameters

$sGUID | The GUID ($FOLDERID_*) that identifies the known folder.
$sFilePath | The folder's new path.
$iFlags | [optional] This parameter can be 0 or the following value. $KF_FLAG_DONT_UNEXPAND
$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.

## Return Value

Success: | 1.
Failure: | 0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.

## Remarks

To call this function on public known folders, the caller must have Administrator privileges. For per-user known
folders the caller only requires User privileges.
To call this function on a folder of type $KF_CATEGORY_COMMON, the calling application must be running with
elevated privileges.
This function cannot be called on folders of type $KF_CATEGORY_FIXED and $KF_CATEGORY_VIRTUAL.
This function requires Windows Vista or later.

## See Also

Search SHSetKnownFolderPath in MSDN Library.