RtlQueryPackageIdentity-Funktion (ntifs.h)

  • Artikel

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

Syntax

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

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.

Packaged

Zeiger auf einen Wert, der ein BOOLEAN-Flag empfängt, das angibt, ob die Anwendung gepackt ist. Verpackt 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 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
Kopfzeile ntifs.h

Weitere Informationen

RtlQueryPackageIdentityEx