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) |