Compartir a través de


Función RtlQueryPackageIdentityEx (ntifs.h)

RtlQueryPackageIdentityEx devuelve el nombre completo del paquete asociado. Opcionalmente, también puede devolver el nombre de la aplicación relativa del paquete y si una aplicación se considera empaquetada.

Sintaxis

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

Parámetros

TokenObject

Identificador de un objeto de token (modo de usuario) que se abrió con TOKEN_QUERY acceso o a un objeto de token sin procesar (modo kernel).

PackageFullName

Puntero a un búfer de caracteres anchos que recibirá la clave de paquete única. El búfer finalizará nulo cuando se haya realizado correctamente.

PackageSize

Puntero al valor que define el tamaño del búfer al que apunta PackageFullName . En la salida, contendrá el tamaño escrito, incluido el valor null de terminación.

AppId

Puntero a un búfer de caracteres anchos que puede recibir el identificador de aplicación relativa del paquete. AppId es opcional y puede ser NULL.

AppIdSize

Puntero al valor que define el tamaño del búfer al que apunta AppId . En la salida, contendrá el tamaño escrito, incluido el valor null de terminación. Si AppId no es NULL, AppIdSize debe apuntar a un valor válido; De lo contrario , AppIdSize debe establecerse en NULL.

DynamicId

Puntero a un valor que recibe un identificador dinámico para la aplicación. DynamicId es opcional y puede ser NULL.

Flags

Puntero a un valor que recibe una máscara de bits de valores para el atributo de paquete.

Valor devuelto

RtlQueryPackageIdentityEx devuelve STATUS_SUCCESS tras la finalización correcta; de lo contrario, devuelve un código como uno de los siguientes.

Código de error Significado
STATUS_INVALID_PARAMETER Un parámetro contiene un valor no válido; por ejemplo, no se proporcionó un valor de tamaño para un búfer que no sea NULL. Se trata de un código de error.
STATUS_NOT_FOUND No existe una identidad de paquete.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1
Encabezado ntifs.h