Função ILFree (shlobj_core.h)

  • Artigo

Libera uma estrutura ITEMIDLIST alocada pelo Shell.

Sintaxe

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

Parâmetros

[in] pidl

Tipo: PIDLIST_RELATIVE

Um ponteiro para a estrutura ITEMIDLIST a ser liberada. Este parâmetro pode ser NULL.

Retornar valor

Nenhum

Comentários

ILFree geralmente é usado com estruturas ITEMIDLIST alocadas por uma das outras funções IL, mas pode ser usada para liberar qualquer estrutura retornada pelo Shell, por exemplo, a estrutura ITEMIDLIST retornada por SHBrowseForFolder ou usada em uma chamada para SHGetFolderLocation.

Nota Ao usar o Windows 2000 ou posterior, use CoTaskMemFree em vez de ILFree. As estruturas ITEMIDLIST são sempre alocadas com o alocador de tarefas COM (Component Object Model) nessas plataformas.
 

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)

Confira também

ILAppendID

ILClone

ILCloneFirst

ILCombine