Fungsi SHCreateDefaultContextMenu (shlobj_core.h)

Membuat objek yang mewakili implementasi menu konteks default Shell.

Sintaks

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

Parameter

[in] pdcm

Jenis: const DEFCONTEXTMENU*

Penunjuk ke struktur DEFCONTEXTMENU yang konstan .

riid

Jenis: REFIID

Referensi ke ID antarmuka antarmuka untuk mendasarkan objek. Ini biasanya IID IContextMenu, IContextMenu2, atau IContextMenu3.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini biasanya digunakan dalam implementasi IShellFolder::GetUIObjectOf. GetUIObjectOf membuat menu konteks yang menggabungkan handler IContextMenu yang ditentukan oleh struktur DEFCONTEXTMENU , dan dapat secara opsional menyediakan implementasi kata kerja menu konteks default seperti membuka, menjelajahi, menghapus, dan menyalin.

Pengoperasian fungsi ini dikendalikan oleh input yang ditentukan dalam struktur DEFCONTEXTMENU . APICDefFolderMenu_Create2 adalah cara lain untuk membangun implementasi menu konteks default. Ini kurang ekspresif daripada SHCreateDefaultContextMenu tetapi ada di platform sebelum Windows Vista.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
DLL	Shell32.dll (versi 6.0.6000 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)