GetCurrentPackageInfo2-Funktion (appmodel.h)

Artikel
08/22/2023

Ruft die Paketinformationen für den aufrufenden Prozess ab, mit der Option, den Typ des Ordnerpfads anzugeben, der für das Paket abgerufen werden soll.

Syntax

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Parameter

flags

Typ: const UINT32

Die Paketkonstanten , die angeben, wie Paketinformationen abgerufen werden. Die PACKAGE_FILTER_* -Flags werden unterstützt.

packagePathType

Typ: PackagePathType

Gibt den Typ des Ordnerpfads an, der für das Paket abgerufen werden soll (der ursprüngliche Installationsordner oder der veränderliche Ordner).

bufferLength

Typ: UINT32*

Bei der Eingabe die Größe des Puffers in Bytes. Bei der Ausgabe die Größe des arrays der zurückgegebenen Strukturen in Bytes.

buffer

Typ: BYTE*

Die Paketinformationen, die als Array von PACKAGE_INFO Strukturen dargestellt werden.

count

Typ: UINT32*

Die Anzahl der Strukturen im Puffer.

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück. Zu den möglichen Fehlercodes gehören die folgenden:

Rückgabecode	Beschreibung
APPMODEL_ERROR_NO_PACKAGE	Der Prozess verfügt über keine Paketidentität.
ERROR_INSUFFICIENT_BUFFER	Der Puffer ist nicht groß genug, um die Daten aufzunehmen. Die erforderliche Größe wird durch bufferLength angegeben.

Hinweise

Der packagePathType-Parameter ist nützlich für Anwendungen, die die Erweiterung windows.mutablePackageDirectories in ihrem Paketmanifest verwenden. Diese Erweiterung gibt einen Ordner unter dem Pfad %ProgramFiles%\ModifiableWindowsAppsApps an, in dem der Inhalt des Installationsordners der Anwendung projiziert wird, sodass Benutzer die Installationsdateien ändern können. Dieses Feature ist derzeit nur für bestimmte Arten von Desktop-PC-Spielen verfügbar, die von Microsoft und unseren Partnern veröffentlicht werden, und ermöglicht es diesen Arten von Spielen, Mods zu unterstützen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	appmodel.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll