Freigeben über


ILFree-Funktion (shlobj_core.h)

Gibt eine ITEMIDLIST-Struktur frei, die von der Shell zugeordnet wird.

Syntax

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

Parameter

[in] pidl

Typ: PIDLIST_RELATIVE

Ein Zeiger auf die zu freigebende ITEMIDLIST-Struktur . Dieser Parameter kann NULL sein.

Rückgabewert

Keine

Bemerkungen

ILFree wird häufig mit ITEMIDLIST-Strukturen verwendet, die von einer der anderen IL-Funktionen zugeordnet sind, aber es kann verwendet werden, um jede solche Struktur freizugeben, die von der Shell zurückgegeben wird, z. B. die ITEMIDLIST-Struktur , die von SHBrowseForFolder oder in einem Aufruf von SHGetFolderLocation verwendet wird.

Hinweis Verwenden Sie bei Verwendung von Windows 2000 oder höher CoTaskMemFree anstelle von ILFree. ITEMIDLIST-Strukturen werden auf diesen Plattformen immer mit dem COM-Aufgabenzuordnungsmodul (Component Object Model) zugeordnet.
 

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 (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

ILAppendID

ILClone

ILCloneFirst

ILCombine