Fungsi SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Menentukan ID Model Pengguna Aplikasi yang ditentukan aplikasi unik (AppUserModelID) yang mengidentifikasi proses saat ini ke taskbar. Pengidentifikasi ini memungkinkan aplikasi untuk mengelompokkan proses dan jendela terkait di bawah satu tombol taskbar.

Sintaks

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Parameter

[in] AppID

Jenis: PCWSTR

Arahkan ke AppUserModelID untuk ditetapkan ke proses saat ini.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Metode ini harus dipanggil selama rutinitas startup awal aplikasi sebelum aplikasi menyajikan UI apa pun atau membuat manipulasi Jump Lists. Ini termasuk setiap panggilan ke SHAddToRecentDocs.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.1 atau yang lebih baru)

Lihat juga

ID Model Pengguna Aplikasi (AppUserModelIDs)

GetCurrentProcessExplicitAppUserModelID

Ekstensi Taskbar