GetCurrentProcessExplicitAppUserModelID-Funktion (shobjidl_core.h)

Ruft die anwendungsdefinierte, explizite Anwendungsbenutzermodell-ID (AppUserModelID) für den aktuellen Prozess ab.

Syntax

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

Parameter

[out] AppID

Typ: PWSTR*

Ein Zeiger, der die Adresse der dem Prozess zugewiesenen AppUserModelID empfängt. Der Aufrufer ist dafür verantwortlich, diese Zeichenfolge mit CoTaskMemFree frei zu geben, wenn sie nicht mehr benötigt wird.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die von dieser Funktion abgerufene AppUserModelID wurde zuvor über SetCurrentProcessExplicitAppUserModelID festgelegt.

Eine Anwendung kann nur eine AppUserModelID abrufen, die explizit festgelegt wurde. Systemseitig zugewiesene Standard-AppUserModelIDs können nicht abgerufen werden. Wenn die Anwendung Kenntnisse über ihre AppUserModelID erfordert, sollte sie eine explizit festlegen.

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

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

IObjectWithAppUserModelID::GetAppID

Taskleistenerweiterungen