Fungsi AssocQueryKeyA (shlwapi.h)

Mencari dan mengambil kunci yang terkait dengan asosiasi file atau protokol dari registri.

Sintaksis

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

Parameter

[in] flags

Jenis: ASSOCF

Bendera yang dapat digunakan untuk mengontrol pencarian. Ini bisa berupa kombinasi nilai ASSOCF, kecuali hanya satu nilai ASSOCF_INIT yang dapat disertakan.

[in] key

Jenis: ASSOCKEY

Nilai ASSOCKEY yang menentukan jenis kunci yang akan dikembalikan.

[in] pszAssoc

Jenis: LPCTSTR

Penunjuk ke string null-terminated yang digunakan untuk menentukan kunci akar. Empat jenis string dapat digunakan.

Ekstensi nama file

Ekstensi nama file, seperti .txt.

CLSID

GUID CLSID dalam format "{GUID}" standar.

ProgID

ProgID aplikasi, seperti Word.Document.8.

Nama yang dapat dieksekusi

Nama file .exe aplikasi. Bendera ASSOCF_OPEN_BYEXENAME harus diatur dalam bendera .

[in] pszExtra

Jenis: LPCTSTR

Penunjuk ke string opsional yang dihentikan null dengan informasi tambahan tentang lokasi string. Biasanya diatur ke kata kerja Shell seperti buka. Atur parameter ini ke null jika tidak digunakan.

[out] phkeyOut

Jenis: HKEY*

Penunjuk ke nilai HKEY kunci.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM jika tidak.

Komentar

Fungsi ini adalah pembungkus untuk antarmuka IQueryAssociations . Ini dimaksudkan untuk menyederhanakan proses penggunaan antarmuka. Untuk diskusi lebih lanjut tentang cara kerja fungsi asosiasi file dan protokol, lihat IQueryAssociations.

Nota

Header shlwapi.h mendefinisikan AssocQueryKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)