Freigeben über

RtlQueryPackageIdentityEx-Funktion (ntifs.h)

  • Artikel

RtlQueryPackageIdentityEx den zugeordneten vollständigen Paketnamen zurück. Sie kann optional auch den relativen Anwendungsnamen des Pakets zurückgeben und ob eine Anwendung als verpackt betrachtet wird.

Syntax

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

Parameter

TokenObject

Handle to a token object (user mode), that was opened with TOKEN_QUERY access, or to a raw token object (kernel mode).

PackageFullName

Zeigen Sie auf einen breiten Zeichenpuffer, der den eindeutigen Paketschlüssel empfängt. Der Puffer wird nach erfolglos beendet.

PackageSize

Zeigen Sie auf den Wert, der die Größe des Puffers definiert, auf den PackageFullName verweist. Bei der Ausgabe enthält sie die Schriftgröße einschließlich der endenden Null.

AppId

Zeigen Sie auf einen breiten Zeichenpuffer, der möglicherweise den relativen Anwendungsbezeichner des Pakets empfängt. AppId- ist optional und kann NULL-sein.

AppIdSize

Zeigen Sie auf den Wert, der die Größe des Puffers definiert, auf den AppId verweist. Bei der Ausgabe enthält sie die Schriftgröße einschließlich der endenden Null. Wenn AppId- nicht NULL-ist, muss AppIdSize auf einen gültigen Wert verweisen; andernfalls sollte AppIdSize- auf NULL-festgelegt werden.

DynamicId

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

Flags

Zeigen Sie 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 Nicht-NULL-Puffer bereitgestellt. Dies ist ein Fehlercode.
STATUS_NOT_FOUND Eine Paketidentität ist nicht vorhanden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8.1
Header- ntifs.h