IApplicationDocumentLists::GetList-Methode (shobjidl_core.h)

  • Artikel

Ruft ein -Objekt ab, das die Auflistung von Zielen darstellt, die in der Kategorie Zuletzt oder Häufig in einer Sprungliste aufgeführt sind.

Syntax

HRESULT GetList(
  [in]  APPDOCLISTTYPE listtype,
  [in]  UINT           cItemsDesired,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parameter

[in] listtype

Typ: APPDOCLISTTYPE

Einer der folgenden Werte, der angibt, aus welcher Kategorie die Liste der Ziele abgerufen werden soll.

ADLT_RECENT (0x0)

0x0. Die Kategorie Zuletzt verwendet , in der die elemente aufgelistet werden, auf die zuletzt zugegriffen wurde.

ADLT_FREQUENT (0x1)

0x1. Die Kategorie Häufig , in der die Elemente aufgelistet werden, auf die am häufigsten zugegriffen wurde.

[in] cItemsDesired

Typ: UINT

Die Anzahl der Elemente, die aus der im Listentyp angegebenen Liste abgerufen werden sollen. Legen Sie diesen Parameter auf 0 fest, um die vollständige Liste abzurufen.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_IObjectArray oder IID_IEnumObjects.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein IObjectArray oder IEnumObjects , das eine Auflistung von IShellItem- oder IShellLink-Objekten (oder eine Mischung aus beiden) darstellt, die die abgerufenen Elemente aus der Liste darstellen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein Element kann sowohl in der Liste Zuletzt als auch in der Liste Häufig angezeigt werden.

Wenn ein Benutzer ein Element in der Kategorie Zuletzt oder Häufig anheftet, wird das Element nicht mehr in der ursprünglichen Kategorie angezeigt, um Duplikate in der Sprungliste zu vermeiden. Das Element wird jedoch weiterhin von dieser Methode zurückgegeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

IApplicationDocumentLists

IApplicationDocumentLists::SetAppID

Taskleistenerweiterungen