Interface IAppPublisher (shappmgr.h)

  • Article

Expose des méthodes de publication d’applications via Ajout/Suppression de programmes dans Panneau de configuration. Il s’agit de l’interface principale implémentée à cet effet.

Héritage

L’interface IAppPublisher hérite de l’interface IUnknown. IAppPublisher a également les types de membres suivants :

Méthodes

L’interface IAppPublisher utilise ces méthodes.

 
IAppPublisher ::EnumApps

Crée un énumérateur pour énumérer toutes les applications publiées par un éditeur d’application pour une catégorie donnée.
IAppPublisher ::GetCategories

Récupère une structure répertoriant les catégories fournies par un éditeur d’application.
IAppPublisher ::GetNumberOfApps

Obsolète. Les clients d’Ajout/Suppression de programmes Panneau de configuration Application peuvent retourner E_NOTIMPL.
IAppPublisher ::GetNumberOfCategories

Obsolète. Les clients de l’application Ajout/Suppression de programmes Panneau de configuration peuvent retourner E_NOTIMPL.

Remarques

Ajouter/supprimer des programmes dans Panneau de configuration crée un objet d’éditeur inscrit et demande son interface IAppPublisher. Vous pouvez créer des objets d’application publiés à l’aide de l’énumérateur d’application, que vous créez à l’aide de IAppPublisher.

Ajout/Suppression de programmes rassemble une liste d’applications publiées auprès des éditeurs, puis utilise un éditeur pour afficher ces applications avec Microsoft Active Directory. Lorsque l’utilisateur clique sur Ajouter de nouveaux programmes dans Ajout/Suppression de programmes, une liste d’applications publiées s’affiche.

Vous pouvez publier des applications dans Ajout/Suppression de programmes à l’aide des interfaces COM (Component Object Model) suivantes.

Lorsque vous implémentez ces interfaces, vous devez inscrire votre objet COM dans le Registre. Pour inscrire votre éditeur, ajoutez l’identificateur de classe (CLSID) de votre objet sous la clé de Registre suivante. 
HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               AppManagement
                  Publishers

Par exemple, si votre éditeur est nommé « Mon serveur de publication », vous créez une clé sous « Éditeurs » nommée « Mon serveur de publication » avec sa valeur de REG_SZ par défaut en tant que CLSID de l’éditeur :

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               AppManagement
                  Publishers
                     My Publisher
                        (Default) = {4D05CD3D-FFED-46bb-B9F1-321C26BE6362}

Vous pouvez également créer les entrées d’inscription de serveur COM classiques comme suit :

HKEY_CLASSES_ROOT
   CLSID
      {469EE8CE-1B86-4524-9042-AAA44FD9C8F2}
         (Default) = Sample Applications Publisher
         InProcServer32
            (Default) = pubdemo.dll
            ThreadingModel = Apartment

Avec l’éditeur inscrit de cette façon, Ajout/Suppression de programmes crée une instance de votre objet en appelant CoCreateInstance pour votre objet et en demandant l’interface IAppPublisher appropriée lorsque la vue Ajouter de nouveaux programmes est remplie. À l’aide de IAppPublisher, Ajout/Suppression de programmes récupère l’énumérateur d’application (IEnumPublishedApps) et les informations qui décrivent les applications publiées. Votre implémentation de IPublishedApp est responsable de l’installation de l’application associée dans sa méthode IPublishedApp ::Install . Ajout/Suppression de programmes appelle cette méthode lorsque l’utilisateur clique sur le bouton Ajouter ou Ajouter plus tard dans l’interface utilisateur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shappmgr.h

Voir aussi

IEnumPublishedApps

IPublishedApp