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 以降) |