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

Controle 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á en null cuando se haya realizado correctamente.

PackageSize

Puntero al valor que define el tamaño del búfer al que PackageFullName apunta. 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 se puede 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 se puede 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 es NULL. Se trata de un código de error.
STATUS_NOT_FOUND	No existe una identidad de paquete.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8.1
encabezado de	ntifs.h