ILFindChild-Funktion (shlobj_core.h)

  • Artikel

Bestimmt, ob eine angegebene ITEMIDLIST-Struktur das untergeordnete Element einer anderen ITEMIDLIST-Struktur ist.

Syntax

PUIDLIST_RELATIVE ILFindChild(
  [in] PIDLIST_ABSOLUTE  pidlParent,
  [in] PCIDLIST_ABSOLUTE pidlChild
);

Parameter

[in] pidlParent

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf die übergeordnete ITEMIDLIST-Struktur .

[in] pidlChild

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf die untergeordnete ITEMIDLIST-Struktur .

Rückgabewert

Typ: PUIDLIST_RELATIVE

Gibt einen Zeiger auf die einfache ITEMIDLIST-Struktur des untergeordneten Elements zurück, wenn pidlChild ein untergeordnetes Element von pidlParent ist. Die zurückgegebene Struktur besteht aus pidlChild, abzüglich der SHITEMID-Strukturen , aus denen pidlParent besteht. Gibt NULL zurück, wenn pidlChild kein untergeordnetes Element von pidlParent ist.

Hinweis Der zurückgegebene Zeiger ist ein Zeiger auf die vorhandene übergeordnete Struktur. Es ist ein Alias für pidlChild. Dem zurückgegebenen Zeiger wird kein neuer Arbeitsspeicher zugeordnet. Es liegt nicht in der Verantwortung des Aufrufers, den zurückgegebenen Wert freizugeben.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)