AssocGetPerceivedType 函式 (shlwapi.h)

發行項
03/13/2024

根據檔案的擴展名擷取檔案的認知類型。

語法

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

參數

[in] pszExt

類型： PCWSTR

緩衝區的指標，其中包含檔案的擴展名。這應該包含前置期間，例如“.txt”。

[out] ptype

類型：認知*

表示認知類型的感知值指標。

[out] pflag

類型： PERCEIVEDFLAG*

值的指標，表示所察覺型別資訊的來源。下列一或多個值。

PERCEIVEDFLAG_UNDEFINED (0x0000)

(PERCEIVED_TYPE_UNSPECIFIED ) 找不到任何認知類型。

PERCEIVEDFLAG_SOFTCODED (0x0001)

感知的類型是透過登錄中的關聯來決定。

PERCEIVEDFLAG_HARDCODED (0x0002)

Windows 原本就知道認知的類型。

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

認知的類型是透過 Windows 提供的編解碼器來決定。

PERCEIVEDFLAG_GDIPLUS (0x0010)

GDI+ 連結庫支持認知的類型。

PERCEIVEDFLAG_WMSDK (0x0020)

Windows Media SDK 支援認知的類型。

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

Windows 壓縮資料夾支持認知的類型。

[out, optional] ppszType

類型： PWSTR*

如果函式傳回成功碼，這包含接收感知類型字串之緩衝區指標的位址，例如“text” 或 “video”。此值可以是 NULL。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

此函式會先比較延伸模組與 Windows 已知的硬式編碼延伸模組集。如果該搜尋無法顯示相符專案，則會搜尋HKEY_CLASSES_ROOT下已註冊的關聯，以尋找符合延伸模組且包含 PerceivedType 值的索引鍵。如果找到該值，則會再次搜尋擴充集以尋找相符專案。如果再次找不到相符專案，則會判斷所察覺的類型PERCEIVED_TYPE_CUSTOM。如果找不到符合延伸模組或 PerceivedType 值的索引鍵，則會將認知類型回報為PERCEIVED_TYPE_UNSPECIFIED。

規格需求

需求	值
最低支援的用戶端	具有 SP2 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shlwapi.dll (6.0 版或更新版本)

共用方式為