Функция AssocGetPerceivedType (shlwapi.h)

Статья
03/05/2024

Извлекает воспринимаемый тип файла на основе его расширения.

Синтаксис

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

Параметры

[in] pszExt

Тип: PCWSTR

Указатель на буфер, содержащий расширение файла. Сюда следует входить начальная точка, например ".txt".

[out] ptype

Тип: PERCEIVED*

Указатель на значение PERCEIVED , указывающее воспринимаемый тип.

[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)

Воспринимаемый тип поддерживается пакетом SDK для Windows Media.

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.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 6.0 или более поздняя)