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

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

  • Статья

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