IResultsFolder::AddIDList-Methode (shobjidl.h)

  • Artikel

Fügt einen Zeiger auf eine Elementbezeichnerliste (PIDL) in einen Ergebnisordner ein.

Syntax

HRESULT AddIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PITEMID_CHILD     *ppidlAdded
);

Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf die IDList des angegebenen Objekts relativ zum Desktop.

[out] ppidlAdded

Typ: PITEMID_CHILD*

Eine PIDL, die relativ zu einem übergeordneten Ordner aus 0 oder 1 SHITEMID-Strukturen besteht. Dieser Parameter kann null sein.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die empfangene PIDL stellt das soeben hinzugefügte Element dar und ist eine eindeutige Darstellung dieses Elements, das von diesem Ergebnisordner generiert wurde. Sie ist nur gültig, wenn sie in Bezug auf diesen Ergebnisordner verwendet wird, und sollte nicht mit einer PIDL in einem anderen Ordner kombiniert werden, einschließlich des Ordners, aus dem dieses Element ursprünglich stammt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h