RtlQueryPackageIdentity-Funktion (ntifs.h)

Artikel
02/07/2025

RtlQueryPackageIdentity- 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. Siehe auch RtlQueryPackageIdentityEx.

Syntax

NTSYSAPI NTSTATUS RtlQueryPackageIdentity(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  PBOOLEAN Packaged
);

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.

Packaged

Zeigen Sie auf einen Wert, der ein BOOLEAN-Flag empfängt, das angibt, ob die Anwendung verpackt ist. Verpackte ist optional und kann NULL-sein.

Rückgabewert

RtlQueryPackageIdentity- 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
Header-	ntifs.h

Siehe auch

RtlQueryPackageIdentityEx

Freigeben über