Partager via

SHAssocEnumHandlers, fonction (shobjidl_core.h)

  • Article

Retourne un objet d’énumération pour un ensemble spécifié de gestionnaires d’extensions de nom de fichier.

Syntaxe

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

Paramètres

[in] pszExtra

Type : PCWSTR

Pointeur vers une mémoire tampon terminée par null qui contient une extension de type de fichier unique, pour instance « .jpg ». Seuls les gestionnaires associés à l’extension donnée sont énumérés. Ce paramètre peut ne pas avoir la valeur NULL.

[in] afFilter

Type : ASSOC_FILTER

Spécifie le filtre de gestionnaire d’énumération appliqué à la liste complète des gestionnaires qui résulte de la valeur donnée dans pszExtra. Une des valeurs suivantes.

Valeur Description
ASSOC_FILTER_NONE Retourne tous les gestionnaires.
ASSOC_FILTER_RECOMMENDED Retourne uniquement les gestionnaires recommandés. Un gestionnaire définit ses status recommandées dans le Registre lorsqu’il est installé. Une status initiale de non recommandé peut être promue ultérieurement en recommandation à la suite d’une action de l’utilisateur.

[out] ppEnumHandler

Type : IEnumAssocHandlers**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers un objet IEnumAssocHandlers .

Valeur retournée

Type : HRESULT

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

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
Bibliothèque Shell32.lib
DLL Shell32.dll