Fungsi SHAssocEnumHandlers (shobjidl_core.h)

Mengembalikan objek enumerasi untuk sekumpulan penangan ekstensi nama file tertentu.

Sintaks

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

Parameter

[in] pszExtra

Jenis: PCWSTR

Penunjuk ke buffer yang dihentikan null yang berisi ekstensi jenis file tunggal, misalnya ".jpg". Hanya handler yang terkait dengan ekstensi yang diberikan yang dijumlahkan. Parameter ini mungkin bukan NULL.

[in] afFilter

Jenis: ASSOC_FILTER

Menentukan filter handler enumerasi yang diterapkan ke daftar lengkap handler yang dihasilkan dari nilai yang diberikan dalam pszExtra. Salah satu nilai berikut.

Nilai	Deskripsi
ASSOC_FILTER_NONE	Mengembalikan semua handler.
ASSOC_FILTER_RECOMMENDED	Kembalikan hanya handler yang direkomendasikan. Handler menetapkan status yang direkomendasikan di registri saat diinstal. Status awal yang tidak direkomendasikan nantinya dapat dipromosikan ke direkomendasikan sebagai akibat dari tindakan pengguna.

[out] ppEnumHandler

Jenis: IEnumAssocHandlers**

Ketika metode ini kembali, berisi alamat penunjuk ke objek IEnumAssocHandlers .

Mengembalikan nilai

Jenis: HRESULT

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

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	shobjidl_core.h (termasuk Shobjidl.h)
Pustaka	Shell32.lib
DLL	Shell32.dll