Antarmuka IQueryAssociations (shlwapi.h)

Mengekspos metode yang menyederhanakan proses pengambilan informasi yang disimpan dalam registri sehubungan dengan menentukan jenis file atau protokol dan mengaitkannya dengan aplikasi.

Warisan

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

Metode

Antarmuka IQueryAssociations memiliki metode ini.

IQueryAssociations::GetData Mencari dan mengambil data biner terkait asosiasi file atau protokol dari registri.
IQueryAssociations::GetEnum Metode ini tidak diterapkan. (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey Mencari dan mengambil kunci terkait asosiasi file atau protokol dari registri.
IQueryAssociations::GetString Mencari dan mengambil file atau string terkait asosiasi protokol dari registri. (IQueryAssociations.GetString)
IQueryAssociations::Init Menginisialisasi antarmuka IQueryAssociations dan mengatur kunci akar ke ProgID yang sesuai.

Keterangan

Kapan harus Menerapkan

Antarmuka ini diekspos oleh Shell atau dengan ekstensi namespace layanan untuk menyederhanakan penanganan file dan asosiasi protokol. Anda tidak boleh mengimplementasikan antarmuka ini.

Kapan Harus Digunakan

Gunakan antarmuka ini jika Anda memerlukan informasi dari registri yang terkait dengan asosiasi file atau protokol. Misalnya, Anda dapat menggunakan antarmuka ini untuk mengambil informasi yang terkait dengan ekstensi nama file seperti string perintah salah satu kata kerjanya.

Jalur registri lengkap atau nilai HKEY tidak diperlukan. Sebagai gantinya, Anda dapat mengambil informasi berdasarkan kriteria seperti ekstensi nama file atau nama yang dapat dieksekusi. Untuk diskusi tentang asosiasi file, lihat Jenis File.

Anda juga dapat mengambil nama aplikasi menggunakan antarmuka ini. Gunakan metode IQueryAssociations::GetString. Atur parameter str ke ASSOCSTR_FRIENDLYAPPNAME.

Untuk menggunakan antarmuka ini, Anda harus terlebih dahulu mengambil pointer ke antarmuka tersebut. Biasanya, Anda mengambil penunjuk QueryInterface dengan memanggil metode IShellFolder::GetUIObjectOf objek Shell. Anda juga dapat mengambil penunjuk antarmuka dengan memanggil AssocCreate (atur clsid ke CLSID_QueryAssociations). Menginisialisasi antarmuka dengan IQueryAssociations::Init. Metode ini mengatur kunci akar yang akan digunakan saat Anda memanggil salah satu dari tiga metode yang tersisa untuk mengambil informasi dari registri. Mereka hanya akan melihat di bawah kunci akar. Anda harus merilis antarmuka ketika Anda tidak lagi membutuhkannya.

Antarmuka IQueryAssociations berguna jika Anda perlu berulang kali mengkueri registri untuk informasi. Setelah antarmuka diinisialisasi, overhead pemanggilan berbagai metode relatif kecil. Ada juga beberapa fungsi terkait, yang tercantum di bagian Lihat Juga, yang memungkinkan Anda mengambil informasi yang sama dari registri dengan satu panggilan fungsi. Meskipun lebih mudah digunakan, mereka menyebabkan overhead membuat dan menginisialisasi IQueryAssociations setiap kali dipanggil. Karena itu, mereka paling cocok untuk penggunaan tunggal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h

Lihat juga

AssocQueryKey

AssocQueryString

AssocQueryStringByKey