Fungsi AssocGetPerceivedType (shlwapi.h)

Artikel
03/15/2023

Mengambil jenis file yang dirasakan berdasarkan ekstensinya.

Sintaks

LWSTDAPI AssocGetPerceivedType(
  [in]            PCWSTR        pszExt,
  [out]           PERCEIVED     *ptype,
  [out]           PERCEIVEDFLAG *pflag,
  [out, optional] PWSTR         *ppszType
);

Parameter

[in] pszExt

Jenis: PCWSTR

Penunjuk ke buffer yang berisi ekstensi file. Ini harus mencakup periode di depan, misalnya ".txt".

[out] ptype

Jenis: PERCEIVED*

Penunjuk ke nilai PERCEIVED yang menunjukkan jenis yang dirasakan.

[out] pflag

Jenis: PERCEIVEDFLAG*

Penunjuk ke nilai yang menunjukkan sumber informasi jenis yang dirasakan. Satu atau beberapa nilai berikut ini.

PERCEIVEDFLAG_UNDEFINED (0x0000)

Tidak ditemukan jenis yang dirasakan (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

Jenis yang dirasakan ditentukan melalui asosiasi dalam registri.

PERCEIVEDFLAG_HARDCODED (0x0002)

Jenis yang dirasakan secara inheren diketahui windows.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

Jenis yang dirasakan ditentukan melalui codec yang disediakan dengan Windows.

PERCEIVEDFLAG_GDIPLUS (0x0010)

Jenis yang dirasakan didukung oleh pustaka GDI+.

PERCEIVEDFLAG_WMSDK (0x0020)

Jenis yang dirasakan didukung oleh Windows Media SDK.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

Jenis yang dirasakan didukung oleh folder terkompresi Windows.

[out, optional] ppszType

Jenis: PWSTR*

Jika fungsi mengembalikan kode keberhasilan, ini berisi alamat pointer ke buffer yang menerima string jenis yang dirasakan, misalnya "teks" atau "video". Nilai ini bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Fungsi ini pertama-tama membandingkan ekstensi dengan sekumpulan ekstensi yang dikodekan secara permanen yang diketahui oleh Windows. Jika pencarian tersebut gagal mengungkapkan kecocokan, asosiasi terdaftar di bawah HKEY_CLASSES_ROOT dicari untuk kunci yang cocok dengan ekstensi dan berisi nilai PerceivedType. Jika nilai tersebut ditemukan, kumpulan ekstensi kembali dicari untuk kecocokan. Jika lagi tidak ada kecocokan yang ditemukan, jenis yang dirasakan ditentukan untuk PERCEIVED_TYPE_CUSTOM. Jika kunci yang cocok dengan ekstensi atau nilai PerceivedType tidak ditemukan, jenis yang dirasakan dilaporkan sebagai PERCEIVED_TYPE_UNSPECIFIED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 6.0 atau yang lebih baru)