Share via

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

  • Статья

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

Синтаксис

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

Параметры

TokenObject

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

PackageFullName

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

PackageSize

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

AppId

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

AppIdSize

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

Packaged

Указатель на значение, которое получает флаг BOOLEAN, указывающий, упаковано ли приложение. Packaged является необязательным и может иметь значение NULL.

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

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

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

Требования

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

См. также раздел

RtlQueryPackageIdentityEx