RtlQueryPackageIdentityEx-Funktion (ntifs.h)

  • Artikel

RtlQueryPackageIdentityEx gibt den zugeordneten vollständigen Paketnamen zurück. Optional kann sie auch den relativen Anwendungsnamen des Pakets zurückgeben und festlegen, ob eine Anwendung als gepackt gilt.

Syntax

NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  LPGUID   DynamicId,
  PULONG64 Flags
);

Parameter

TokenObject

Behandeln Sie ein Tokenobjekt (Benutzermodus), das mit TOKEN_QUERY Zugriff geöffnet wurde, oder für ein unformatiertes Tokenobjekt (Kernelmodus).

PackageFullName

Zeiger auf einen Puffer mit breitem Zeichen, der den eindeutigen Paketschlüssel erhält. Der Puffer wird bei erfolglos beendet.

PackageSize

Zeiger auf den Wert, der die Größe des Puffers definiert, auf den PackageFullName verweist. Bei der Ausgabe enthält es die geschriebene Größe einschließlich des beendenden NULL.

AppId

Zeiger auf einen Puffer mit breitem Zeichen, der möglicherweise den relativen Anwendungsbezeichner des Pakets empfängt. AppId ist optional und kann NULL sein.

AppIdSize

Zeiger auf den Wert, der die Größe des Puffers definiert, auf den AppId verweist. Bei der Ausgabe enthält es die geschriebene Größe einschließlich des beendenden NULL. Wenn AppId nicht NULL ist, muss AppIdSize auf einen gültigen Wert verweisen. Andernfalls sollte AppIdSize auf NULL festgelegt werden.

DynamicId

Zeiger auf einen Wert, der eine dynamische ID für die Anwendung empfängt. DynamicId ist optional und kann NULL sein.

Flags

Zeiger auf einen Wert, der eine Bitmaske von Werten für das Paketattribute empfängt.

Rückgabewert

RtlQueryPackageIdentityEx gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Andernfalls wird ein Code wie einer der folgenden zurückgegeben.

Fehlercode Bedeutung
STATUS_INVALID_PARAMETER Ein Parameter enthält einen ungültigen Wert. Beispielsweise wurde kein Größenwert für einen Puffer ohne NULL angegeben. Dies ist ein Fehlercode.
STATUS_NOT_FOUND Eine Paketidentität ist nicht vorhanden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1
Kopfzeile ntifs.h