AssocGetPerceivedType-Funktion (shlwapi.h)

Artikel
03/04/2024

Ruft den wahrgenommenen Typ einer Datei basierend auf ihrer Erweiterung ab.

Syntax

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

Parameter

[in] pszExt

Typ: PCWSTR

Ein Zeiger auf einen Puffer, der die Dateierweiterung enthält. Dies sollte den vorangestellten Zeitraum einschließen, z. B. ".txt".

[out] ptype

Typ: PERCEIVED*

Ein Zeiger auf einen PERCEIVED-Wert , der den wahrgenommenen Typ angibt.

[out] pflag

Typ: PERCEIVEDFLAG*

Ein Zeiger auf einen Wert, der die Quelle der wahrgenommenen Typinformationen angibt. Mindestens einer der folgenden Werte:

PERCEIVEDFLAG_UNDEFINED (0x0000)

Es wurde kein wahrgenommener Typ gefunden (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

Der wahrgenommene Typ wurde durch eine Zuordnung im Register bestimmt.

PERCEIVEDFLAG_HARDCODED (0x0002)

Der wahrgenommene Typ ist Windows von Natur aus bekannt.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

Der wahrgenommene Typ wurde durch einen mit Windows bereitgestellten Codec bestimmt.

PERCEIVEDFLAG_GDIPLUS (0x0010)

Der wahrgenommene Typ wird von der GDI+-Bibliothek unterstützt.

PERCEIVEDFLAG_WMSDK (0x0020)

Der wahrgenommene Typ wird vom Windows Media SDK unterstützt.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

Der wahrgenommene Typ wird von komprimierten Windows-Ordnern unterstützt.

[out, optional] ppszType

Typ: PWSTR*

Wenn die Funktion einen Erfolgscode zurückgibt, enthält dieser die Adresse eines Zeigers auf einen Puffer, der die wahrgenommene Typzeichenfolge für instance "text" oder "video" empfängt. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion vergleicht zunächst die Erweiterung mit einem hartcodierten Satz von Erweiterungen, die Windows bekannt sind. Wenn bei dieser Suche keine Übereinstimmung angezeigt wird, werden die registrierten Zuordnungen unter HKEY_CLASSES_ROOT nach einem Schlüssel gesucht, der der Erweiterung entspricht und einen PerceivedType-Wert enthält. Wenn dieser Wert gefunden wird, wird der Erweiterungssatz erneut nach einer Übereinstimmung durchsucht. Wenn wiederum keine Übereinstimmung gefunden wird, wird der wahrgenommene Typ als PERCEIVED_TYPE_CUSTOM bestimmt. Wenn entweder ein Schlüssel, der der Erweiterung entspricht, oder ein PerceivedType-Wert nicht gefunden wird, wird der wahrgenommene Typ als PERCEIVED_TYPE_UNSPECIFIED gemeldet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 6.0 oder höher)

Freigeben über