Метод IShellLibrary::GetFolders (shobjidl_core.h)

Статья
08/26/2023

Возвращает набор дочерних папок, содержащихся в библиотеке.

Синтаксис

HRESULT GetFolders(
  [in]  LIBRARYFOLDERFILTER lff,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Параметры

[in] lff

Тип: LIBRARYFOLDERFILTER

Одно из следующих значений LIBRARYFOLDERFILTER , определяющее папки для получения. Эти флаги не могут быть объединены.

LFF_FORCEFILESYSTEM (1)

Получение только папок файловой системы. Папки файловой системы — это папки, для которых задан атрибут SFGAO_FILESYSTEM .

LFF_STORAGEITEMS (2)

Получение всех папок, которые можно привязать к объектам IStorage . Эти папки представляют собой папки, для которых задан атрибут SFGAO_STORAGE или SFGAO_FILESYSTEM .

LFF_ALLITEMS (3)

Получение всех папок в библиотеке.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса для получения в ppv. Обычно это значение IID_IShellItemArray, но оно также может быть IID_IObjectCollection, IID_IObjectArray или IID любого другого интерфейса, реализованного CShellItemArray.

[out] ppv

Тип: void**

Указатель на интерфейс, запрошенный в riid. Если этот вызов завершается ошибкой, это значение равно NULL.

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

Тип: HRESULT

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Вызов выполнен успешно, и указанные папки были возвращены в ppv.
S_FALSE	Вызов был успешным, но не все указанные папки были возвращены в ppv.
E_	Этот метод может возвращать другие значения ошибок.

Для получения наилучших результатов используйте макрос IID_PPV_ARGS , определенный в Objbase.h, для параметров riid и ppv . Этот макрос предоставляет правильный IID на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кода.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)