SHGetNameFromIDList 関数 (shobjidl_core.h)

IDList によって識別される項目の表示名を取得します。

構文

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

パラメーター

[in] pidl

型: PCIDLIST_ABSOLUTE

項目を識別する PIDL。

[in] sigdnName

型: SIGDN

取得する表示名の種類を指定する SIGDN 列挙体の値。

[out] ppszName

型: PWSTR*

この関数が正常に返されるときに、取得した表示名へのポインターのアドレスを受け取る値。

戻り値

型: HRESULT

この関数が成功すると、S_OKが返 されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

ppszName が指す文字列が不要になったら、呼び出し元が解放するのは、呼び出し元の責任です。 *ppszName で CoTaskMemFree を呼び出してメモリを解放します。

Requirements