IApplicationDocumentLists::GetList, méthode (shobjidl_core.h)

Article
08/26/2023

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)