IApplicationDocumentLists::SetAppID-Methode (shobjidl_core.h)

  • Artikel

Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, deren Ziellisten abgerufen werden. Diese Methode ist optional.

Syntax

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parameter

[in] pszAppID

Typ: LPCWSTR

Ein Zeiger auf die AppUserModelID des Prozesses, dessen Darstellung der Taskleistenschaltfläche die Sprungliste empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn die Anwendung über eine explizite AppUserModelID verfügt, muss diese Methode aufgerufen werden, bevor Sie GetList aufrufen.

Nachdem eine AppUserModelID durch die SetAppID-Methode eines Objekts angegeben wurde, wird die AppUserModelID für die Lebensdauer dieses Objekts im Objekt gespeichert, sofern sie nicht durch einen anderen Aufruf von SetAppID überschrieben wird.

Einige Anwendungen deklarieren keine explizite AppUserModelID und sollten diese Methode nicht aufrufen. In diesem Fall wird die Identität der Anwendung abgeleitet, wenn IApplicationDocumentLists::GetList aufgerufen wird. Es gibt jedoch einen Leistungsvorteil, wenn diese Berechnungen vermieden werden, sodass Anwendungen, die benutzerdefinierte Sprunglisten bereitstellen, empfohlen werden , explizite AppUserModelIDs zu verwenden.

Anforderungen

   
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 (einschließlich Shobjidl.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

IApplicationDocumentLists

Taskleistenerweiterungen