IAppPublisher-Schnittstelle (shappmgr.h)

  • Artikel

Macht Methoden zum Veröffentlichen von Anwendungen über Software in Systemsteuerung verfügbar. Dies ist die zu diesem Zweck implementierte Prinzipalschnittstelle.

Vererbung

Die IAppPublisher-Schnittstelle erbt von der IUnknown-Schnittstelle . IAppPublisher verfügt auch über folgende Arten von Membern:

Methoden

Die IAppPublisher-Schnittstelle verfügt über diese Methoden.

 
IAppPublisher::EnumApps

Erstellt einen Enumerator zum Aufzählen aller Anwendungen, die von einem Anwendungsherausgeber für eine bestimmte Kategorie veröffentlicht wurden.
IAppPublisher::GetCategories

Ruft eine Struktur ab, die die von einem Anwendungsherausgeber bereitgestellten Kategorien auflistet.
IAppPublisher::GetNumberOfApps

Veraltet. Clients von Software Systemsteuerung Anwendung können E_NOTIMPL zurückgeben.
IAppPublisher::GetNumberOfCategories

Veraltet. Clients der Systemsteuerung Anwendung "Programme hinzufügen/entfernen" geben möglicherweise E_NOTIMPL zurück.

Hinweise

Programme hinzufügen/entfernen in Systemsteuerung erstellt ein registriertes Herausgeberobjekt und fordert dessen IAppPublisher-Schnittstelle an. Sie können veröffentlichte Anwendungsobjekte mithilfe des Anwendungsenumerators erstellen, den Sie mit IAppPublisher erstellen.

"Programme hinzufügen/entfernen" sammelt eine Liste der veröffentlichten Anwendungen von Herausgebern und verwendet dann einen Herausgeber, um diese Anwendungen mit Microsoft Active Directory anzuzeigen. Wenn der Benutzer unter Programme hinzufügen/entfernen auf Neue Programme hinzufügen klickt, wird eine Liste der veröffentlichten Anwendungen angezeigt.

Sie können Anwendungen unter Programme mit den folgenden COM-Schnittstellen (Component Object Model) veröffentlichen.

Wenn Sie diese Schnittstellen implementieren, müssen Sie Ihr COM-Objekt in der Registrierung registrieren. Um Ihren Herausgeber zu registrieren, fügen Sie den Klassenbezeichner (CLSID) Ihres Objekts unter dem folgenden Registrierungsschlüssel hinzu. 
HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               AppManagement
                  Publishers

Wenn Ihr Herausgeber beispielsweise den Namen "Mein Verleger" hat, erstellen Sie unter "Verleger" einen neuen Schlüssel mit dem Namen "Mein Verleger" mit dem Standardwert REG_SZ als CLSID des Herausgebers:

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

Sie können auch die typischen COM-Serverregistrierungseinträge wie folgt erstellen:

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

Wenn der Herausgeber auf diese Weise registriert ist, erstellt Add/Remove Programs eine instance Ihres Objekts, indem CoCreateInstance für Ihr Objekt aufgerufen und die entsprechende IAppPublisher-Schnittstelle angefordert wird, wenn die Ansicht Neue Programme hinzufügen aufgefüllt wird. Mithilfe von IAppPublisher ruft "Software hinzufügen/entfernen" den Anwendungsenumerator (IEnumPublishedApps) und Informationen ab, die die veröffentlichten Anwendungen beschreiben. Ihre Implementierung von IPublishedApp ist für die Installation der zugeordneten Anwendung in der IPublishedApp::Install-Methode verantwortlich. Software ruft diese Methode auf, wenn der Benutzer auf der Benutzeroberfläche auf die Schaltfläche Hinzufügen oder Später hinzufügen klickt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shappmgr.h

Weitere Informationen

IEnumPublishedApps

IPublishedApp