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

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

  • Статья

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

Синтаксис

SHSTDAPI SHCreateDefaultContextMenu(
  [in]  const DEFCONTEXTMENU *pdcm,
        REFIID               riid,
  [out] void                 **ppv
);

Параметры

[in] pdcm

Тип: const DEFCONTEXTMENU*

Указатель на константную структуру DEFCONTEXTMENU .

riid

Тип: REFIID

Ссылка на идентификатор интерфейса, на котором будет основываться объект. Обычно это ИДЕНТИФИКАТОР IContextMenu, IContextMenu2 или IContextMenu3.

[out] ppv

Тип: void**

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

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

Тип: HRESULT

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

Комментарии

Эта функция обычно используется в реализации IShellFolder::GetUIObjectOf. GetUIObjectOf создает контекстное меню, которое объединяет обработчики IContextMenu , заданные структурой DEFCONTEXTMENU , и может при необходимости предоставлять реализации команд контекстного меню по умолчанию, таких как открытие, изучение, удаление и копирование.

Операция этой функции управляется входными данными, указанными в структуре DEFCONTEXTMENU . Api CDefFolderMenu_Create2 — еще один способ создания реализации контекстного меню по умолчанию. Она менее выразительна, чем SHCreateDefaultContextMenu , но существует на платформах до Windows Vista.

Требования

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