IlFindChild, fonction (shlobj_core.h)

Détermine si une structure ITEMIDLIST spécifiée est l’enfant d’une autre structure ITEMIDLIST .

Syntaxe

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

Paramètres

[in] pidlParent

Type : PCIDLIST_ABSOLUTE

Pointeur vers la structure ITEMIDLIST parente.

[in] pidlChild

Type : PCIDLIST_ABSOLUTE

Pointeur vers la structure ITEMIDLIST enfant.

Valeur retournée

Type : PUIDLIST_RELATIVE

Retourne un pointeur vers la structure ITEMIDLIST simple de l’enfant si pidlChild est un enfant de pidlParent. La structure retournée se compose de pidlChild, moins les structures SHITEMID qui composent pidlParent. Renvoie la valeur NULL si pidlChild n’est pas un enfant de pidlParent.

Note Le pointeur retourné est un pointeur vers la structure parente existante. Il s’agit d’un alias pour pidlChild. Aucune nouvelle mémoire n’est allouée en association avec le pointeur retourné. Il n’est pas de la responsabilité de l’appelant de libérer la valeur retournée.

 

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)