Функция SHCreateItemInKnownFolder (shobjidl_core.h)

Статья
03/02/2024

Создает объект элемента оболочки для одного файла, который существует в известной папке.

Синтаксис

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

Параметры

[in] kfid

Тип: REFKNOWNFOLDERID

Ссылка на KNOWNFOLDERID, GUID , идентифицирующий папку, содержащую элемент.

dwKFFlags

Тип: DWORD

Флаги, указывающие специальные параметры в извлечении объекта. Это значение может быть равно 0; в противном случае одно или несколько значений KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Тип: PCWSTR

Указатель на буфер с пустым завершением, который содержит имя файла нового элемента в виде строки Юникода. Этот параметр также может иметь значение NULL. В этом случае создается элемент IShellItem , представляющий саму известную папку.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, представляющего элемент, извлекаемая через ppv. Обычно это значение IID_IShellItem или IID_IShellItem2.

[out] ppv

Тип: void**

При успешном возврате этой функции содержит указатель интерфейса, запрошенный в riid. Обычно это IShellItem или IShellItem2.

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll
Набор API	ext-ms-win-shell-shell32-l1-2-0 (представлено в Windows 8.1)

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

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

Поделиться через