AssocGetPerceivedType, fonction (shlwapi.h)

  • Article

Récupère le type perçu d’un fichier en fonction de son extension.

Syntaxe

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

Paramètres

[in] pszExt

Type : PCWSTR

Pointeur vers une mémoire tampon qui contient l’extension du fichier. Cela doit inclure la période de début, par exemple « .txt ».

[out] ptype

Type : PERCEIVED*

Pointeur vers une valeur PERCEIVED qui indique le type perçu.

[out] pflag

Type : PERCEIVEDFLAG*

Pointeur vers une valeur qui indique la source des informations de type perçues. Une ou plusieurs des valeurs suivantes.

PERCEIVEDFLAG_UNDEFINED (0x0000)

Aucun type perçu n’a été trouvé (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

Le type perçu a été déterminé par une association dans le registre.

PERCEIVEDFLAG_HARDCODED (0x0002)

Le type perçu est intrinsèquement connu de Windows.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

Le type perçu a été déterminé par le biais d’un codec fourni avec Windows.

PERCEIVEDFLAG_GDIPLUS (0x0010)

Le type perçu est pris en charge par la bibliothèque GDI+.

PERCEIVEDFLAG_WMSDK (0x0020)

Le type perçu est pris en charge par le Kit de développement logiciel (SDK) Windows Media.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

Le type perçu est pris en charge par les dossiers compressés Windows.

[out, optional] ppszType

Type : PWSTR*

Si la fonction retourne un code de réussite, il contient l’adresse d’un pointeur vers une mémoire tampon qui reçoit la chaîne de type perçue, pour instance « texte » ou « vidéo ». Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction compare d’abord l’extension à un ensemble codé en dur d’extensions connus de Windows. Si cette recherche ne parvient pas à révéler une correspondance, les associations inscrites sous HKEY_CLASSES_ROOT sont recherchées pour une clé qui correspond à l’extension et contient une valeur PerceivedType. Si cette valeur est trouvée, le jeu d’extensions est à nouveau recherché pour une correspondance. Si une fois de plus aucune correspondance n’est trouvée, le type perçu est déterminé comme étant PERCEIVED_TYPE_CUSTOM. Si une clé correspondant à l’extension ou une valeur PerceivedType est introuvable, le type perçu est signalé comme PERCEIVED_TYPE_UNSPECIFIED.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 6.0 ou ultérieure)