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

Статья
08/26/2023

Открывает окно Windows Обозреватель с выбранными элементами в определенной папке.

Синтаксис

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

Параметры

[in] pidlFolder

Тип: PCIDLIST_ABSOLUTE

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

cidl

Тип: UINT

Количество элементов в массиве выбора apidl. Если cidl равно нулю, то pidlFolder должен указывать на полностью указанный ITEMIDLIST, описывающий отдельный элемент для выбора. Эта функция открывает родительскую папку и выбирает этот элемент.

[in, optional] apidl

Тип: PCUITEMID_CHILD_ARRAY

Указатель на массив структур PIDL, каждая из которых является элементом для выбора в целевой папке, на которую ссылается pidlFolder.

dwFlags

Тип: DWORD

Необязательные флаги. В Windows XP этот параметр игнорируется. В Windows Vista определены следующие флаги.

OFASI_EDIT (0x0001)

Выберите элемент и переведите его имя в режим редактирования. Этот флаг можно использовать только при выборе одного элемента. При выборе нескольких элементов он игнорируется.

OFASI_OPENDESKTOP (0x0002)

Выберите элемент или элементы на рабочем столе, а не в окне windows Обозреватель. Обратите внимание, что если рабочий стол скрыт за открытыми окнами, он не будет отображаться.

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 6.0 или более поздняя)

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