Metode IApplicationAssociationRegistration::QueryCurrentDefault (shobjidl_core.h)

Artikel
03/11/2023

Menentukan aplikasi default untuk jenis asosiasi tertentu. Ini adalah aplikasi default yang diluncurkan oleh ShellExecute untuk jenis tersebut.

Sintaks

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

Parameter

[in] pszQuery

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi ekstensi atau protokol nama file, seperti .mp3 atau http.

[in] atQueryType

Jenis: ASSOCIATIONTYPE

Salah satu nilai enumerasi ASSOCIATIONTYPE yang menentukan jenis asosiasi, seperti ekstensi atau jenis MIME.

[in] alQueryLevel

Jenis: ASSOCIATIONLEVEL

Salah satu nilai enumerasi ASSOCIATIONLEVEL yang menentukan tingkat asosiasi, seperti per pengguna atau mesin. Ini biasanya AL_EFFECTIVE.

[out] ppszAssociation

Jenis: LPWSTR*

Ketika metode ini kembali, berisi alamat penunjuk ke ProgID yang mengidentifikasi asosiasi default saat ini.

Catatan Merupakan tanggung jawab aplikasi panggilan untuk merilis string melalui CoTaskMemFree.

Nilai kembali

Jenis: HRESULT

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

Keterangan

String yang dihasilkan biasanya progID yang cocok dengan salah satu ProgID yang terkait dengan aplikasi terdaftar, tetapi ada beberapa pengecualian: Jika string yang dikembalikan adalah protokol default mesin, string tersebut adalah string warisan yang menunjukkan baris perintah ke handler .exe alih-alih ProgID. Demikian pula, jika mengembalikan jenis MIME default komputer, ia mengembalikan string pengidentifikasi kelas warisan (CLSID) alih-alih ProgID.

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)

Lihat juga

Program Default

IApplicationAssociationRegistration

Bagikan melalui