Метод IKnownFolderManager::GetFolder (shobjidl_core.h)

Возвращает объект , представляющий известную папку, определяемую ее KNOWNFOLDERID. Объект позволяет запрашивать определенные свойства папки, получать текущий путь к папке, перенаправлять папку в другое расположение и получать путь к папке в виде ITEMIDLIST.

Синтаксис

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

Параметры

[in] rfid

Тип: REFKNOWNFOLDERID

Ссылка на KNOWNFOLDERID.

[out] ppkf

Тип: IKnownFolder**

При возврате этим методом содержит указатель интерфейса на объект IKnownFolder , представляющий папку.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае, включая следующее:

Код возврата	Описание
E_INVALIDARG	Помимо прочего, это значение может указывать на то, что параметр радиочастотной идентификации ссылается на KNOWNFOLDERID , который отсутствует в системе. Не все значения KNOWNFOLDERID присутствуют во всех системах. Используйте IKnownFolderManager::GetFolderIds , чтобы получить набор значений KNOWNFOLDERID для текущей системы.

Комментарии

Чтобы вызвать этот метод, вызывающий объект должен иметь по крайней мере права пользователя.

Когда следует использовать

Используйте этот метод, если вы точно знаете, какая известная папка вы ищете, и хотите получить к ней доступ напрямую.

Требования

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

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

IKnownFolderManager

Пример: известные папки