IObjectWithAppUserModelID-Schnittstelle (shobjidl_core.h)

Macht Methoden verfügbar, die es Implementierern eines benutzerdefinierten IAssocHandler-Objekts ermöglichen, Zugriff auf seine explizite Anwendungsbenutzermodell-ID (AppUserModelID) bereitzustellen. Anhand dieser Informationen wird ermittelt, ob ein bestimmter Dateityp der Sprungliste einer Anwendung hinzugefügt werden kann.

Vererbung

Die IObjectWithAppUserModelID-Schnittstelle erbt von der IUnknown-Schnittstelle . IObjectWithAppUserModelID verfügt auch über folgende Membertypen:

Methoden

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

IObjectWithAppUserModelID::GetAppID Ruft die explizite Anwendungsbenutzermodell-ID (AppUserModelID) eines Dateityphandlers ab, sofern eine deklariert wurde.
IObjectWithAppUserModelID::SetAppID Gibt eine eindeutige anwendungsdefinierte Anwendungsbenutzermodell-ID (AppUserModelID) an, die das Objekt als Handler für einen bestimmten Dateityp identifiziert. Diese Methode wird von Anwendungen verwendet, die dynamische AppUserModelIDs erfordern.

Hinweise

Nur Dateitypen, für die eine Anwendung ein registrierter Handler ist, werden in der Sprungliste dieser Anwendung angezeigt. Wenn eine Anwendung eine explizite AppUserModelID verwendet, um sich selbst und die Fenster und Prozesse zu identifizieren, die dazu gehören, muss diese AppUserModelID auch in der Implementierung eines Handlers festgelegt werden, damit der Handler als dieser Anwendung zugeordnet erkannt wird. Wenn die Anwendung auf eine Datei zugreift, sodass SHAddToRecentDocs aufgerufen wird, wird versucht, die Datei der Kategorie Zuletzt oderHäufig oder möglicherweise einer benutzerdefinierten Kategorie in der Sprungliste dieser Anwendung hinzuzufügen. Wenn die Anwendung ein registrierter Handler für diesen Dateityp ist, der durch die AppUserModelID des Handlers identifiziert wird, die mit der AppUserModelID der Anwendung übereinstimmt, wird diese Datei der Sprungliste hinzugefügt. Wenn dies nicht der Fall ist, wird sie gefiltert und wird nicht angezeigt.

Wann sollte implementiert werden?

Eine Implementierung dieser Schnittstelle wird in Windows bereitgestellt. Anwendungen, die benutzerdefinierte Shellordner erstellen, die eine Zuordnungshandlerenumeration verfügbar machen, die vom System benötigt wird, um die in der Sprungliste der Anwendung zulässigen Dateien zu bestimmen, sollten eigene Versionen implementieren.

Verwendungs-Gründe

Dieses Objekt ist nur erforderlich, wenn Ihre Anwendung explizite AppUserModelIDs verwendet. Ohne eine explizite AppUserModelID, die verfügbar gemacht werden soll, ist dieses Objekt nicht erforderlich.

IObjectWithAppUserModelID wird immer als Teil eines größeren Objekts verwendet, das explizite AppUserModelIDs verwendet und diese Informationen für das System verfügbar machen möchte.

Das System ruft die in einem Handler implementierte IObjectWithAppUserModelID::GetAppID-Methode auf, um zu bestimmen, ob die Anwendung ein registrierter Handler für einen Dateityp ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

Taskleistenerweiterungen