GetPackagePathByFullName2-Funktion (appmodel.h)

Artikel
02/23/2024

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 der Paketdatei.

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*

Ein Zeiger auf eine Variable, die die Anzahl von Zeichen (WCHARs) in der Paketpfadzeichenfolge enthält, die das NULL-Abschlusszeichen enthält.

Zuerst übergeben Sie NULL an path , um die Anzahl der Zeichen abzurufen. Sie verwenden diese Nummer, um Speicherplatz für den Pfad zuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um den Pfad auszufüllen.

path

Typ: PWSTR

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

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
ERROR_INSUFFICIENT_BUFFER	Der im Pfad angegebene 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	KernelBase.dll

Weitere Informationen

GetPackagePathByFullName

Freigeben über