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 |