Функция SHParseDisplayName (shlobj_core.h)
Преобразует отображаемое имя объекта пространства имен оболочки в список идентификаторов элементов и возвращает атрибуты объекта . Эта функция является предпочтительным методом преобразования строки в указатель в список идентификаторов элементов (PIDL).
Синтаксис
SHSTDAPI SHParseDisplayName(
[in] PCWSTR pszName,
[in, optional] IBindCtx *pbc,
[out] PIDLIST_ABSOLUTE *ppidl,
[in] SFGAOF sfgaoIn,
[out, optional] SFGAOF *psfgaoOut
);
Параметры
[in] pszName
Тип: LPCWSTR
Указатель на широкую строку с нулем, содержащую отображаемое имя для анализа.
[in, optional] pbc
Тип: IBindCtx*
Контекст привязки, управляющий операцией синтаксического анализа. Этот параметр обычно имеет значение NULL.
[out] ppidl
Тип: PIDLIST_ABSOLUTE*
Адрес указателя на переменную типа ITEMIDLIST , которая получает список идентификаторов элемента для объекта . При возникновении ошибки этот параметр имеет значение NULL.
[in] sfgaoIn
Тип: SFGAOF
Значение ULONG , указывающее атрибуты для запроса. Чтобы запросить один или несколько атрибутов, инициализируйте этот параметр флагами, представляющими интересующие атрибуты. Список доступных флагов SFGAO см. в разделе SFGAO.
[out, optional] psfgaoOut
Тип: SFGAOF*
Указатель на ULONG. При возврате задаются атрибуты, которые имеют значение true для объекта и были запрошены в sfgaoIn . Флаги атрибутов объекта могут быть равны нулю или сочетанию флагов SFGAO. Список доступных флагов SFGAO см. в разделе SFGAO.
Возвращаемое значение
Тип: HRESULT
Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Эту функцию следует вызывать из фонового потока. В этом случае пользовательский интерфейс перестанет отвечать на запросы.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj_core.h (включая Shlobj.h) |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 6.0 или более поздняя) |