SHParseDisplayName 関数 (shlobj_core.h)

Shell 名前空間オブジェクトの表示名を項目識別子リストに変換し、オブジェクトの属性を返します。 この関数は、文字列を項目識別子リスト (PIDL) へのポインターに変換するために推奨される方法です。

構文

SHSTDAPI SHParseDisplayName(
  [in]            PCWSTR           pszName,
  [in, optional]  IBindCtx         *pbc,
  [out]           PIDLIST_ABSOLUTE *ppidl,
  [in]            SFGAOF           sfgaoIn,
  [out, optional] SFGAOF           *psfgaoOut
);

パラメーター

[in] pszName

種類: LPCWSTR

解析する表示名を含む、0 で終わるワイド文字列へのポインター。

[in, optional] pbc

型: IBindCtx*

解析操作を制御するバインド コンテキスト。 通常、このパラメーターは NULL に設定 されます。

[out] ppidl

種類: PIDLIST_ABSOLUTE*

オブジェクトの項目識別子リストを受け取る ITEMIDLIST 型の変数へのポインターのアドレス。 エラーが発生した場合、このパラメーターは NULL に設定されます。

[in] sfgaoIn

種類: SFGAOF

クエリする属性を指定する ULONG 値。 1 つ以上の属性を照会するには、目的の属性を表すフラグを使用してこのパラメーターを初期化します。 使用可能な SFGAO フラグの一覧については、「 SFGAO」を参照してください。

[out, optional] psfgaoOut

種類: SFGAOF*

ULONG へのポインター。 返されると、オブジェクトに対して true であり、 sfgaoIn で要求された属性が設定されます。 オブジェクトの属性フラグには、0 または SFGAO フラグの組み合わせを指定できます。 使用可能な SFGAO フラグの一覧については、「 SFGAO」を参照してください。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、バックグラウンド スレッドから呼び出す必要があります。 これを行わないと、UI の応答が停止する可能性があります。

要件

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

こちらもご覧ください

Ibindctx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

ITEMIDLIST

SHGetPathFromIDList