GetPackageInfo2-Funktion (appmodel.h)

Artikel
08/22/2023

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

Syntax

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

Parameter

packageInfoReference

Typ: PACKAGE_INFO_REFERENCE

Ein Verweis auf Paketinformationen.

flags

Typ: const UINT32

Die Paketkonstanten , die angeben, wie Paketinformationen abgerufen werden.

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 der zurückgegebenen Paketinformationen in Bytes.

buffer

Typ: BYTE*

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

count

Typ: UINT32*

Die Anzahl der Pakete 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
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