Função ILFindChild (shlobj_core.h)

  • Artigo

Determina se uma estrutura ITEMIDLIST especificada é o filho de outra estrutura ITEMIDLIST .

Sintaxe

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

Parâmetros

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

Um ponteiro para a estrutura ITEMIDLIST pai.

[in] pidlChild

Tipo: PCIDLIST_ABSOLUTE

Um ponteiro para a estrutura ITEMIDLIST filho.

Retornar valor

Tipo: PUIDLIST_RELATIVE

Retorna um ponteiro para a estrutura ITEMIDLIST simples do filho se pidlChild for um filho de pidlParent. A estrutura retornada consiste em pidlChild, menos as estruturas SHITEMID que compõem pidlParent. Retornará NULL se pidlChild não for um filho de pidlParent.

Nota O ponteiro retornado é um ponteiro para a estrutura pai existente. É um alias para pidlChild. Nenhuma nova memória é alocada em associação com o ponteiro retornado. Não é responsabilidade do chamador liberar o valor retornado.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)