AssocGetPerceivedType, fonction (shlwapi.h)
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) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour