GetPackageId-Funktion (appmodel.h)

Artikel
02/23/2024

Ruft den Paketbezeichner (ID) für den angegebenen Prozess ab.

Syntax

LONG GetPackageId(
  [in]            HANDLE hProcess,
  [in, out]       UINT32 *bufferLength,
  [out, optional] BYTE   *buffer
);

Parameter

[in] hProcess

Typ: HANDLE

Ein Handle für den Prozess, der über das zugriffsrecht PROCESS_QUERY_INFORMATION oder PROCESS_QUERY_LIMITED_INFORMATION verfügt. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[in, out] bufferLength

Typ: UINT32*

Bei der Eingabe die Größe des Puffers in Bytes. Bei der Ausgabe die Größe der zurückgegebenen Struktur in Bytes.

[out, optional] buffer

Typ: BYTE*

Die Paket-ID, dargestellt als PACKAGE_ID-Struktur .

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 von bufferLength angegeben.

Anforderungen

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

Siehe auch

GetCurrentPackageId

GetPackageFamilyName

GetPackageFullName

Freigeben über