Redirige un dossier connu à un nouvel emplacement
#include <WinAPIShellEx.au3>
_WinAPI_ShellSetKnownFolderPath ( $sGUID, $sFilePath [, $iFlags = 0 [, $hToken = 0]] )
$sGUID | Le GUID ($FOLDERID_*) qui identifie le dossier connu. |
$sFilePath | Nouveau le chemin du dossier. |
$iFlags | [optionnel] Ce paramètre peut être 0 ou la valeur suivante. $KF_FLAG_DONT_UNEXPAND |
$hToken | [optionnel] Le jeton d'accès qui représente un utilisateur particulier. Si ce paramètre est 0, la fonction demande le dossier connu pour l'utilisateur actuel. L'affectation du paramètre $hToken par la valeur (-1) indique l'utilisateur par défaut. Notez que l'accès aux dossiers de l'utilisateur par défaut nécessite des privilèges d'administrateur. |
Succès: | Retourne 1. |
Échec: | Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur HRESULT. |
Pour appeler cette fonction sur les dossiers connus publics, l'appelant doit avoir des privilèges d'administrateur. Pour chaque utilisateur des dossiers connus l'appelant nécessite seulement des privilèges de l'utilisateur.
Pour appeler cette fonction sur un dossier de type $KF_CATEGORY_COMMON, l'application appelante doit être exécuté avec des privilèges élevés.
Cette fonction ne peut être appelée sur des dossiers de type $KF_CATEGORY_FIXED et $KF_CATEGORY_VIRTUAL.
Cette fonction nécessite Windows Vista ou une version ultérieure.
Consultez SHSetKnownFolderPath dans la librairie MSDN.