Функция RtlQueryPackageIdentityEx (ntifs.h)

Статья
02/29/2024

RtlQueryPackageIdentityEx возвращает связанное полное имя пакета. При необходимости можно также вернуть имя приложения относительного пакета, а также определить, считается ли приложение упакованным.

Синтаксис

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

Параметры

TokenObject

Обработка объекта маркера (режим пользователя), который был открыт с доступом TOKEN_QUERY, или необработанного объекта маркера (режим ядра).

PackageFullName

Указатель на расширенный буфер символов, который получит уникальный ключ пакета. При успешном выполнении буфер будет завершаться со значением NULL.

PackageSize

Указатель на значение, определяющее размер буфера, на который указывает PackageFullName . В выходных данных он будет содержать записанный размер, включая завершающее значение NULL.

AppId

Указатель на расширенный буфер символов, который может получить идентификатор приложения относительно пакета. AppId является необязательным и может иметь значение NULL.

AppIdSize

Указатель на значение, определяющее размер буфера, на который указывает AppId . В выходных данных он будет содержать записанный размер, включая завершающее значение NULL. Если Значение AppId не равно NULL, AppIdSize должно указывать на допустимое значение; в противном случае AppIdSize должен иметь значение NULL.

DynamicId

Указатель на значение, которое получает динамический идентификатор приложения. DynamicId является необязательным и может иметь значение NULL.

Flags

Указатель на значение, которое получает битовую маску значений для атрибута пакета.

Возвращаемое значение

RtlQueryPackageIdentityEx возвращает STATUS_SUCCESS после успешного завершения; в противном случае возвращается код, например один из следующих.

Код ошибки	Значение
STATUS_INVALID_PARAMETER	Параметр содержит недопустимое значение; Например, для буфера, отличного от NULL, не указано значение размера. Это код ошибки.
STATUS_NOT_FOUND	Удостоверение пакета не существует.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1
Верхняя часть	ntifs.h

Поделиться через