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

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

Синтаксис

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

Параметры

[in] pszPath

Тип: LPCWSTR

Указатель на строку Юникода длиной, заканчивающуюся null, MAX_PATH, содержащую путь к известной папке.

[in] mode

Тип: FFFP_MODE

Одно из следующих значений, определяющих точность совпадения пути и известной папки:

FFFP_EXACTMATCH

Извлекает только определенную известную папку для заданного пути к файлу.

FFFP_NEARESTPARENTMATCH

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

[out] ppkf

Тип: IKnownFolder**

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

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

Тип: HRESULT

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

Требования

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

IKnownFolderManager

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