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

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

Синтаксис

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

Параметры

[in] pdcm

Тип: const DEFCONTEXTMENU*

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

riid

Тип: REFIID

Ссылка на идентификатор интерфейса интерфейса, на котором будет основываться объект. Обычно это IID IContextMenu, IContextMenu2 или IContextMenu3.

[out] ppv

Тип: void**

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

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

Тип: HRESULT

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

Замечания

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

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

Требования

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