IApplicationDocumentLists::GetList, méthode (shobjidl_core.h)
Récupère un objet qui représente la collection de destinations répertoriées dans la catégorie Récent ou Fréquent d’une liste de raccourcis.
Syntaxe
HRESULT GetList(
[in] APPDOCLISTTYPE listtype,
[in] UINT cItemsDesired,
[in] REFIID riid,
[out] void **ppv
);
Paramètres
[in] listtype
Type : APPDOCLISTTYPE
Une des valeurs suivantes qui spécifie à partir de quelle catégorie la liste des destinations doit être récupérée.
ADLT_RECENT (0x0)
0x0. Catégorie Récent , qui répertorie les éléments les plus récemment consultés.
ADLT_FREQUENT (0x1)
0x1. La catégorie Fréquente , qui répertorie les éléments qui ont été consultés le plus grand nombre de fois.
[in] cItemsDesired
Type : UINT
Nombre d’éléments à récupérer à partir de la liste spécifiée dans listtype. Définissez ce paramètre sur 0 pour récupérer la liste complète.
[in] riid
Type : REFIID
Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IObjectArray ou IID_IEnumObjects.
[out] ppv
Type : void**
Lorsque cette méthode retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’un IObjectArray ou d’un IEnumObjects qui représente une collection d’objets IShellItem ou IShellLink (ou un mélange des deux) qui représentent les éléments récupérés dans la liste.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Un élément peut apparaître dans les listes Récents et Fréquents .
Si un utilisateur épingle un élément dans les catégories Récents ou Fréquents , l’élément n’est plus affiché dans sa catégorie d’origine pour éviter la duplication dans la liste de raccourcis. Toutefois, l’élément sera toujours retourné par cette méthode.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (inclure Shobjidl.h) |
| Bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 6.1 ou ultérieure) |