Функция SHCreateShellFolderView (shlobj_core.h)

  • Статья

Создает новый экземпляр объекта представления папки оболочки по умолчанию (DefView).

Синтаксис

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

Параметры

[in] pcsfv

Тип: const SFV_CREATE*

Указатель на структуру SFV_CREATE , описывающую особенности, используемые при создании этого экземпляра объекта представления папок оболочки.

[out] ppsv

Тип: IShellView**

При успешном возвращении этой функции содержит указатель интерфейса на новый объект IShellView . При сбое это значение равно NULL.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

SHCreateShellFolderView рекомендуется использовать вместо SHCreateShellFolderViewEx из-за большей гибкости его элементов для участия в различных сценариях, предоставления новых функциональных возможностей представления и взаимодействия с другими объектами.

При работе с несколькими экземплярами IShellView может потребоваться проверить, какой объект представления папок оболочки по умолчанию. Для этого вызовите QueryInterface для объекта с помощью IID_CDefView IID. Этот вызов выполняется успешно, только если он выполнен в объекте представления папки оболочки по умолчанию.

Источники данных, использующие объект представления папок оболочки по умолчанию, должны реализовывать следующие интерфейсы:

При необходимости они также могут реализовать IPersistFolder3.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 5.0 или более поздняя)
Набор API ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393)

См. также раздел

SFV_CREATE

SHCreateShellFolderViewEx