UDF > WinAPIEx > ShellEx >


_WinAPI_ShellGetKnownFolderIDList

Obtient le chemin d'un dossier connu en tant que structure ITEMIDLIST

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

Paramètres

$sGUID Le GUID ($FOLDERID_*) qui identifie les dossiers standard enregistrés dans le système.
$iFlags [optionnel] Les flags qui spécifient des options de récupération spéciales. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes:
    $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 ou une version ultérieure
    $KF_FLAG_ALIAS_ONLY
$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 de l'utilisateur actuel. Définir le paramètre $hToken à une valeur de (-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 la PIDL du dossier.
Échec: Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur HRESULT.

Remarques

Pour libérer la PIDL reournée, appelez la fonction _WinAPI_CoTaskMemFree().

Cette fonction nécessite Windows Vista ou une version ultérieure.

En relation

_WinAPI_CoTaskMemFree

Voir aussi

Consultez SHGetKnownFolderIDList dans la librairie MSDN.