ILFree 関数 (shlobj_core.h)

シェルによって割り当てられた ITEMIDLIST 構造体を解放します。

構文

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

パラメーター

[in] pidl

種類: PIDLIST_RELATIVE

解放する ITEMIDLIST 構造体へのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

なし

解説

ILFree は、多くの場合、他の IL 関数の 1 つによって割り当てられた ITEMIDLIST 構造体と共に使用されますが、シェルによって返されるこのような構造体 (たとえば、SHBrowseForFolder によって返される ITEMIDLIST 構造体、または SHGetFolderLocation の呼び出しで使用される ITEMIDLIST 構造体) を解放するために使用できます。

メモ Windows 2000 以降を使用する場合は、 ILFree ではなく CoTaskMemFree を 使用 します。 ITEMIDLIST 構造体は、常にそれらのプラットフォームのコンポーネント オブジェクト モデル (COM) タスク アロケーターを使用して割り当てられます。

 

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)

こちらもご覧ください

ILAppendID

ILClone

ILCloneFirst

ILCombine