Bagikan melalui

Fungsi RtlQueryPackageIdentityEx (ntifs.h)

  • Artikel

RtlQueryPackageIdentityEx mengembalikan nama paket lengkap terkait. Secara opsional juga dapat mengembalikan nama aplikasi relatif paket, dan apakah aplikasi dianggap dibungkus.

Sintaks

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

Parameter

TokenObject

Tangani ke objek token (mode pengguna) yang dibuka dengan akses TOKEN_QUERY, atau ke objek token mentah (mode kernel).

PackageFullName

Penunjuk ke buffer karakter lebar yang akan menerima kunci paket unik. Buffer akan dihentikan null setelah berhasil.

PackageSize

Penunjuk ke nilai yang menentukan ukuran buffer yang dirujuk PackageFullName . Pada output, itu akan berisi ukuran tertulis termasuk yang mengakhiri null.

AppId

Penunjuk ke buffer karakter lebar yang mungkin menerima pengidentifikasi aplikasi relatif paket. AppId bersifat opsional dan dapat berupa NULL.

AppIdSize

Penunjuk ke nilai yang menentukan ukuran buffer yang dituju appId . Pada output, itu akan berisi ukuran tertulis termasuk yang mengakhiri null. Jika AppId bukan NULL, AppIdSize harus menunjuk ke nilai yang valid; jika tidak , AppIdSize harus diatur ke NULL.

DynamicId

Penunjuk ke nilai yang menerima ID dinamis untuk aplikasi. DynamicId bersifat opsional dan dapat berupa NULL.

Flags

Penunjuk ke nilai yang menerima bitmask nilai untuk atribut paket.

Mengembalikan nilai

RtlQueryPackageIdentityEx mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan; jika tidak, kode akan dikembalikan seperti salah satu dari berikut ini.

Kode Kesalahan Makna
STATUS_INVALID_PARAMETER Parameter berisi nilai yang tidak valid; misalnya, nilai ukuran tidak disediakan untuk buffer non-NULL. Ini adalah kode kesalahan.
STATUS_NOT_FOUND Identitas paket tidak ada.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1
Header ntifs.h