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)