UDF > WinAPIEx > ShellEx >


_WinAPI_ShellSetKnownFolderPath

Redirige un dossier connu à un nouvel emplacement

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

Paramètres

$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.

Valeur de retour

Succès: Retourne 1.
Échec: Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur HRESULT.

Remarques

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.

Voir aussi

Consultez SHSetKnownFolderPath dans la librairie MSDN.