GetPackagePathByFullName-Funktion (appmodel.h)

  • Artikel

Ruft den Pfad des angegebenen Pakets ab.

Syntax

LONG GetPackagePathByFullName(
  [in]            PCWSTR packageFullName,
  [in, out]       UINT32 *pathLength,
  [out, optional] PWSTR  path
);

Parameter

[in] packageFullName

Typ: PCWSTR

Der vollständige Name der Paketdatei.

[in, out] 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.

[out, optional] 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.

Anforderungen

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

Siehe auch

GetPackagePathByFullName2