Fungsi AssocQueryKeyW (shlwapi.h)

Artikel
03/15/2023

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

Sintaks

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

Parameter

[in] flags

Jenis: ASSOCF

Bendera yang dapat digunakan untuk mengontrol pencarian. Ini bisa menjadi kombinasi nilai ASSOCF apa pun, kecuali bahwa 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 yang dihentikan null 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 terbuka. Atur parameter ini ke NULL jika tidak digunakan.

[out] phkeyOut

Jenis: HKEY*

Penunjuk ke nilai HKEY kunci.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM sebaliknya.

Keterangan

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.

Catatan

Header shlwapi.h mendefinisikan AssocQueryKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui