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

Статья
08/26/2023

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

Синтаксис

SHSTDAPI CDefFolderMenu_Create2(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in, optional] HWND                  hwnd,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IShellFolder          *psf,
  [in, optional] LPFNDFMCALLBACK       pfn,
                 UINT                  nKeys,
  [in, optional] const HKEY            *ahkeys,
  [out]          IContextMenu          **ppcm
);

Параметры

[in, optional] pidlFolder

Тип: PCIDLIST_ABSOLUTE

Структура ITEMIDLIST для родительской папки. Это значение может иметь значение NULL.

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна. Это значение может иметь значение NULL.

cidl

Тип: UINT

Количество структур ITEMIDLIST в массиве, на который указывает apidl.

[in, optional] apidl

Тип: PCUITEMID_CHILD_ARRAY*

Указатель на массив структур ITEMIDLIST , по одному для каждого выбранного элемента.

[in, optional] psf

Тип: IShellFolder*

Указатель на интерфейс IShellFolder родительской папки. Этот IShellFolder должен поддерживать интерфейс IDataObject . Если это не так, CDefFolderMenu_Create2 завершается сбоем и возвращает E_NOINTERFACE. Это значение может иметь значение NULL.

[in, optional] pfn

Тип: LPFNDFMCALLBACK

Объект обратного вызова LPFNDFMCALLBACK . Это значение может иметь значение NULL , если объект обратного вызова не требуется.

nKeys

Тип: UINT

Количество разделов реестра в массиве, на который указывает ahkeys.

Примечание Максимальное количество разделов реестра — 16. Вызывающие стороны должны применять это ограничение, так как API этого не делает. В противном случае это может привести к повреждению памяти.

[in, optional] ahkeys

Тип: const HKEY*

Указатель на массив разделов реестра, указывающих обработчики контекстного меню, используемые с записями меню. Дополнительные сведения об обработчиках контекстного меню см. в разделе Создание обработчиков контекстного меню. Этот массив может содержать не более 16 разделов реестра.

[out] ppcm

Тип: IContextMenu**

Адрес указателя интерфейса IContextMenu , который при успешном возврате этой функции указывает на объект IContextMenu , представляющий контекстное меню.

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

Тип: HRESULT

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

Требования


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

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

SHCreateDefaultContextMenu

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