Fungsi RtlQueryPackageIdentity (ntifs.h)

Artikel
02/29/2024

RtlQueryPackageIdentity mengembalikan nama paket lengkap terkait. Ini secara opsional juga dapat mengembalikan nama aplikasi relatif paket, dan apakah aplikasi dianggap dibungkus. Lihat juga RtlQueryPackageIdentityEx.

Sintaks

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

Parameter

TokenObject

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

PackageFullName

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

PackageSize

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

AppId

Pointer 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.

Packaged

Penunjuk ke nilai yang menerima bendera BOOLEAN yang menunjukkan apakah aplikasi dibungkus. Paket bersifat opsional dan dapat berupa NULL.

Mengembalikan nilai

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

Lihat juga

RtlQueryPackageIdentityEx

Bagikan melalui