ILNext-Funktion (shlobj_core.h)

Ruft die nächste SHITEMID-Struktur in einer ITEMIDLIST-Struktur ab.

Syntax

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

Parameter

[in] pidl

Typ: PCUIDLIST_RELATIVE

Eine konstante, nicht ausgerichtete, relative PIDL, für die die nächste SHITEMID-Struktur abgerufen wird.

Rückgabewert

Typ: PCUIDLIST_RELATIVE

Wenn diese Funktion zurückgibt, enthält sie eines von drei Ergebnissen: Wenn pidl gültig ist und nicht die letzte SHITEMID in der ITEMIDLIST, enthält sie einen Zeiger auf die nächste ITEMIDLIST-Struktur . Wenn die letzte ITEMIDLIST-Struktur übergeben wird, enthält sie NULL, das das Ende der PIDL signalisiert. Für andere Werte von pidl ist der Rückgabewert bedeutungslos.

Hinweise

Für die Verwendung, bei der STRICT_TYPED_ITEMIDS definiert ist.

Verwenden Sie ILIsEmpty, um zu überprüfen, ob der Rückgabewert NULL ist.

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	shlobj_core.h (einschließlich Shlobj.h)