Bagikan melalui

IAssocHandler::Metode IsRecommended (shobjidl_core.h)

  • Artikel

Menunjukkan apakah aplikasi terdaftar sebagai handler yang direkomendasikan untuk jenis file yang dikueri.

Sintaks

HRESULT IsRecommended();

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika program direkomendasikan; jika tidak, S_FALSE.

Keterangan

Aplikasi yang mendaftarkan diri mereka sebagai penangan untuk jenis file tertentu dapat menentukan apakah mereka adalah penangan yang direkomendasikan. Ini tidak berpengaruh pada perilaku aktual aplikasi saat diluncurkan. Ini hanya diberikan sebagai petunjuk kepada pengguna dan nilai yang dapat digunakan UI secara terprogram, jika diinginkan. Misalnya, dialog Buka Dengan Shell memisahkan entri ke dalam Program yang Direkomendasikan dan Program Lainnya.

Perhatikan bahwa rekomendasi program dapat berubah dari waktu ke waktu. Salah satu contoh disediakan ketika pengguna memilih aplikasi dari Program Lain dari dialog Buka Dengan untuk membuka jenis file tertentu. Itu dapat menyebabkan Shell "mempromosikan" aplikasi tersebut ke status yang direkomendasikan untuk jenis file tersebut. Karena status yang direkomendasikan dapat berubah dari waktu ke waktu, aplikasi tidak boleh menyimpan nilai ini, tetapi mengkuerinya setiap kali diperlukan.

Jika SHAssocEnumHandlers dipanggil dengan bendera ASSOC_FILTER_RECOMMENDED, maka hanya penangan yang direkomendasikan yang dikembalikan. Jika bendera ASSOC_FILTER_NONE digunakan, maka Anda harus memanggil IAssocHandler::IsRecommended pada setiap objek IAssocHandler untuk menentukan apakah disarankan atau tidak.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h (termasuk Shobjidl.h)