ILCreateFromPathW

ILCreateFromPathW (Unicode) 関数は、指定されたファイルパスに関連付けられた ITEMIDLIST 構造体を返す。

ILCreateFromPathW pszPath

pszPath : [wstr] 型: PCTSTR パスを含むヌル終端 Unicode 文字列へのポインタ。この文字列は終端ヌル文字を含めて MAX_PATH 文字以下でなければならない。

(プラグイン / モジュール : shell32.dll)

解説

ILCreateFromPathW (Unicode) 関数は、指定されたファイルパスに関連付けられた ITEMIDLIST
構造体を返す。

[戻り値]
型: PIDLIST_ABSOLUTE 指定パスに対応する ITEMIDLIST 構造体へのポインタを返す。

[備考]
ITEMIDLIST の使用が終わったら ILFree を呼び出して解放すること。
> [!NOTE] > shlobj_core.h ヘッダは UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI
版または Unicode 版を自動的に選択するエイリアスとして ILCreateFromPath
を定義している。エンコーディング非依存のエイリアスとエンコーディング依存のコードを混在させるとミスマッチが生じ、コンパイルエラーや実行時エラーを引き起こす可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報