GetPackagePathByFullName2-Funktion (appmodel.h)

Artikel
03/05/2025

Ruft den Pfad des angegebenen Pakets mit der Option zum Angeben des Typs des Ordnerpfads ab, der für das Paket abgerufen werden soll.

Syntax

LONG GetPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parameter

packageFullName

Typ: PCWSTR-

Der vollständige Name des Pakets.

packagePathType

Typ: PackagePathType-

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

pathLength

Typ: UINT32*

Ein Zeiger auf eine Variable, die die Anzahl der Zeichen (WCHARs) in der Paketpfadzeichenfolge enthält, die den Null-Terminator enthält.

Zuerst übergeben Sie NULL- an Pfad, um die Anzahl der Zeichen abzurufen. Sie verwenden diese Zahl, um Speicherplatz für Pfadzuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um Pfadauszufüllen.

path

Typ: PWSTR-

Ein Zeiger auf den Arbeitsspeicher, der die Paketpfadzeichenfolge empfängt, die den Null-Terminator enthält.

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich verläuft, wird ERROR_SUCCESSzurückgegeben. Andernfalls gibt die Funktion einen Fehlercode zurück. Die möglichen Fehlercodes umfassen Folgendes.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Der durch Pfad angegebene Puffer ist nicht groß genug, um die Daten aufzunehmen. Die erforderliche Größe wird durch pathLength-angegeben.

Bemerkungen

Der parameter packagePathType ist nützlich für Anwendungen, die die Erweiterung "windows.mutablePackageDirectories" im Paketmanifest verwenden. Diese Erweiterung gibt einen Ordner unter dem pfad %ProgramFiles%\ModifiableWindowsAppsApps 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 es ermöglicht diese Arten von Spielen, Mods zu unterstützen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2016 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	appmodel.h
Library	Kernel32.lib
DLL-	KernelBase.dll

Siehe auch

GetPackagePathByFullName-

Freigeben über