Antarmuka IObjectWithAppUserModelID (shobjidl_core.h)

Mengekspos metode yang memungkinkan pelaksana objek IAssocHandler kustom untuk menyediakan akses ke ID Model Pengguna Aplikasi eksplisitnya (AppUserModelID). Informasi ini digunakan untuk menentukan apakah jenis file tertentu dapat ditambahkan ke Jump List aplikasi.

Warisan

Antarmuka IObjectWithAppUserModelID mewarisi dari antarmuka IUnknown . IObjectWithAppUserModelID juga memiliki jenis anggota ini:

Metode

Antarmuka IObjectWithAppUserModelID memiliki metode ini.

IObjectWithAppUserModelID::GetAppID Mengambil ID Model Pengguna Aplikasi eksplisit handler jenis file (AppUserModelID), jika telah dideklarasikan.
IObjectWithAppUserModelID::SetAppID Menentukan ID Model Pengguna Aplikasi yang ditentukan aplikasi unik (AppUserModelID) yang mengidentifikasi objek sebagai handler untuk jenis file tertentu. Metode ini digunakan oleh aplikasi yang memerlukan AppUserModelIDs dinamis.

Keterangan

Hanya jenis file yang aplikasinya adalah handler terdaftar yang muncul di Jump List aplikasi tersebut. Ketika aplikasi menggunakan AppUserModelID eksplisit untuk mengidentifikasi dirinya sendiri dan jendela dan proses yang termasuk dalamnya, AppUserModelID juga harus diatur dalam implementasi handler sehingga handler dikenali terkait dengan aplikasi tersebut. Ketika aplikasi mengakses file sehingga SHAddToRecentDocs dipanggil sebagai hasilnya, upaya dilakukan untuk menambahkan file ke kategori Terbaru atau Sering , atau mungkin kategori kustom, dalam Jump List aplikasi tersebut. Jika aplikasi adalah handler terdaftar untuk jenis file tersebut, diidentifikasi dengan AppUserModelID handler yang cocok dengan AppUserModelID aplikasi, file tersebut ditambahkan ke Jump List. Jika tidak, itu difilter dan tidak muncul.

Kapan Harus Menerapkan

Implementasi antarmuka ini disediakan di Windows. Aplikasi yang membuat folder Shell kustom yang mengekspos enumerasi handler asosiasi yang diperlukan oleh sistem untuk menentukan file yang diizinkan dalam Jump List aplikasi harus menerapkan versi mereka sendiri.

Kapan Harus Digunakan

Objek ini diperlukan hanya jika aplikasi Anda menggunakan AppUserModelIDs eksplisit. Tanpa AppUserModelID eksplisit untuk diekspos, objek ini tidak perlu diekspos.

IObjectWithAppUserModelID selalu digunakan sebagai bagian dari objek yang lebih besar yang menggunakan AppUserModelIDs eksplisit dan ingin mengekspos informasi tersebut ke sistem.

Sistem memanggil metode IObjectWithAppUserModelID::GetAppID yang diterapkan pada handler untuk menentukan apakah aplikasi adalah handler terdaftar untuk jenis file.

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)

Lihat juga

ID Model Pengguna Aplikasi (AppUserModelIDs)

Ekstensi Bilah Tugas