IApplicationDocumentLists::GetList-Methode (shobjidl_core.h)
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) |