ILFindChild 関数 (shlobj_core.h)

  • [アーティクル]

指定した ITEMIDLIST 構造体が別の ITEMIDLIST 構造体の子であるかどうかを判断します。

構文

PUIDLIST_RELATIVE ILFindChild(
  [in] PIDLIST_ABSOLUTE  pidlParent,
  [in] PCIDLIST_ABSOLUTE pidlChild
);

パラメーター

[in] pidlParent

種類: PCIDLIST_ABSOLUTE

親 ITEMIDLIST 構造体へのポインター。

[in] pidlChild

種類: PCIDLIST_ABSOLUTE

子 ITEMIDLIST 構造体へのポインター。

戻り値

種類: PUIDLIST_RELATIVE

pidlChild が pidlParent の子である場合は、子の単純な ITEMIDLIST 構造体へのポインターを返します。 返される構造体は pidlChild から pidlParent を構成する SHITEMID 構造体を差し引いた値で構成されます。 pidlChild が pidlParent の子でない場合は NULL を返します。

メモ 返されるポインターは、既存の親構造体へのポインターです。 pidlChild のエイリアスです。 返されたポインターと関連付けて、新しいメモリは割り当てされません。 戻り値を解放するのは呼び出し元の責任ではありません。
 

要件

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