Bagikan melalui

Fungsi AssocQueryStringA (shlwapi.h)

Mencari dan mengambil string terkait asosiasi file atau protokol dari registri.

Sintaksis

LWSTDAPI AssocQueryStringA(
  [in]            ASSOCF   flags,
  [in]            ASSOCSTR str,
  [in]            LPCSTR   pszAssoc,
  [in, optional]  LPCSTR   pszExtra,
  [out, optional] LPSTR    pszOut,
  [in, out]       DWORD    *pcchOut
);

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] str

Jenis: ASSOCSTR

Nilai ASSOCSTR yang menentukan jenis string yang akan dikembalikan.

[in] pszAssoc

Jenis: LPCTSTR

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

  1. Ekstensi nama file: Ekstensi nama file, seperti .txt.
  2. CLSID: GUID CLSID dalam format standar "{GUID}".
  3. ProgID: ProgID aplikasi, seperti Word.Document.8.
  4. Nama yang dapat dieksekusi: Nama file .exe aplikasi. Bendera ASSOCF_OPEN_BYEXENAME harus diatur dalam bendera .

[in, optional] pszExtra

Jenis: LPCTSTR

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, optional] pszOut

Jenis: LPTSTR

Penunjuk ke string null-terminated yang, ketika fungsi ini berhasil dikembalikan, menerima string yang diminta. Atur parameter ini ke NULL untuk mengambil ukuran buffer yang diperlukan.

[in, out] pcchOut

Jenis: DWORD*

Penunjuk ke nilai yang, saat memanggil fungsi, diatur ke jumlah karakter dalam pszOut buffer. Ketika fungsi berhasil dikembalikan, nilai diatur ke jumlah karakter yang benar-benar ditempatkan dalam buffer.

Jika bendera ASSOCF_NOTRUNCATE diatur dalam bendera dan buffer yang ditentukan dalam pszOut terlalu kecil, fungsi mengembalikan E_POINTER dan nilai diatur ke ukuran buffer yang diperlukan.

Jika pszOut null, fungsi mengembalikan S_FALSE dan pcchOut menunjuk ke ukuran yang diperlukan, dalam karakter, dari buffer.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan nilai kesalahan COM standar, termasuk yang berikut ini:

Kesalahan Arti
S_OK Keberhasilan.
E_POINTER Buffer pszOut terlalu kecil untuk menahan seluruh string.
S_FALSE pszOut NULL . pcchOut berisi ukuran buffer yang diperlukan.

Komentar

Fungsi ini adalah pembungkus untuk antarmuka IQueryAssociations . Fungsi AssocQueryString dimaksudkan untuk menyederhanakan proses penggunaan antarmuka IQueryAssociations.

Setelah item dipilih, host harus memutuskan handler pratinjau mana (jika ada) yang tersedia untuk item tersebut. Penangan pratinjau biasanya terdaftar pada ekstensi nama file atau ProgID, tetapi beberapa penangan pratinjau hanya dibuat untuk item dalam folder shell tertentu (handler pratinjau MAPI dikaitkan dengan item apa pun yang berasal dari folder MAPI Shell, misalnya). Dengan demikian, host harus menggunakan IQueryAssociations untuk menentukan handler pratinjau mana yang akan digunakan. Untuk diskusi lebih lanjut tentang cara kerja fungsi asosiasi file dan protokol, lihat IQueryAssociations.

Nota

Header shlwapi.h mendefinisikan AssocQueryString 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)
  • Last updated on