ILFree-Funktion (shlobj_core.h)

Artikel
03/02/2024

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