GetCurrentPackagePath2-Funktion (appmodel.h)

Artikel
02/26/2024

Ruft den Paketpfad für den aufrufenden Prozess mit der Option zum Angeben des Typs des Ordnerpfads ab, der für das Paket abgerufen werden soll.

Syntax

LONG GetCurrentPackagePath2(
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parameter

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).

pathLength

Typ: UINT32*

Bei der Eingabe die Größe des Pfadpuffers in Zeichen. Bei der Ausgabe wird die Größe des zurückgegebenen Paketpfads in Zeichen einschließlich des NULL-Abschlusszeichens angezeigt.

path

Typ: PWSTR

Der Paketpfad.

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück. Folgende Fehlercodes sind möglich.

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 pathLength angegeben.

Hinweise

Der parameter packagePathType ist nützlich für Anwendungen, die die Erweiterung windows.mutablePackageDirectories in ihrem Paketmanifest verwenden. Diese Erweiterung gibt einen Ordner unter dem Pfad %ProgramFiles%\ModifiableWindowsApps an, in dem der Inhalt des Installationsordners der Anwendung projiziert wird, damit 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