Partager via

IAssocHandler::IsRecommended, méthode (shobjidl_core.h)

  • Article

Indique si l’application est inscrite en tant que gestionnaire recommandé pour le type de fichier interrogé.

Syntaxe

HRESULT IsRecommended();

Valeur de retour

Type : HRESULT

Retourne S_OK si le programme est recommandé ; sinon, S_FALSE.

Remarques

Les applications qui s’inscrivent elles-mêmes en tant que gestionnaires pour des types de fichiers particuliers peuvent spécifier s’il s’agit de gestionnaires recommandés. Cela n’a aucun effet sur le comportement réel des applications lors du lancement. Il est simplement fourni à titre d’indicateur à l’utilisateur et d’une valeur que l’interface utilisateur peut utiliser par programmation, si vous le souhaitez. Par exemple, la boîte de dialogue Ouvrir avec de l’interpréteur de commandes sépare les entrées dans Programmes recommandés et Autres programmes.

Notez que les recommandations de programme peuvent changer au fil du temps. Un exemple est fourni lorsque l’utilisateur choisit une application dans autres programmes de la boîte de dialogue Ouvrir avec pour ouvrir un type de fichier particulier. Cela peut amener l’interpréteur de commandes à « promouvoir » cette application à des status recommandées pour ce type de fichier. Étant donné que les status recommandées peuvent changer au fil du temps, les applications ne doivent pas mettre en cache cette valeur, mais l’interroger chaque fois que cela est nécessaire.

Si SHAssocEnumHandlers a été appelé avec l’indicateur ASSOC_FILTER_RECOMMENDED, seuls les gestionnaires recommandés sont retournés. Si l’indicateur ASSOC_FILTER_NONE a été utilisé, vous devez appeler IAssocHandler::IsRecommended sur chaque objet IAssocHandler pour déterminer s’il est recommandé ou non.

Configuration requise

   
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)