Fonction RtlQueryPackageIdentity (ntifs.h)

Article
02/07/2025

RtlQueryPackageIdentity retourne le nom complet du package associé. Il peut également retourner le nom de l’application relative du package et si une application est considérée comme empaquetée. Voir aussi RtlQueryPackageIdentityEx.

Syntaxe

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

Paramètres

TokenObject

Gérez un objet de jeton (mode utilisateur) ouvert avec TOKEN_QUERY accès ou à un objet de jeton brut (mode noyau).

PackageFullName

Pointeur vers une mémoire tampon de caractères large qui recevra la clé de package unique. La mémoire tampon est terminée par null en cas de réussite.

PackageSize

Pointeur vers la valeur qui définit la taille de la mémoire tampon vers laquelle PackageFullName pointe vers. En sortie, elle contiendra la taille écrite, y compris la valeur null de fin.

AppId

Pointeur vers une mémoire tampon de caractères large qui peut recevoir l’identificateur d’application relatif du package. appId est facultatif et peut être NULL.

AppIdSize

Pointeur vers la valeur qui définit la taille de la mémoire tampon vers laquelle AppId pointe. En sortie, elle contiendra la taille écrite, y compris la valeur null de fin. Si appId n’est pas NULL, AppIdSize doit pointer vers une valeur valide ; sinon, appIdSize doit être défini sur NULL .

Packaged

Pointeur vers une valeur qui reçoit un indicateur BOOLEAN indiquant si l’application est empaquetée. empaquetée est facultative et peut être NULL.

Valeur de retour

RtlQueryPackageIdentity retourne STATUS_SUCCESS une fois l’exécution réussie ; sinon, elle retourne un code tel que l’un des éléments suivants.

Code d’erreur	Signification
STATUS_INVALID_PARAMETER	Un paramètre contient une valeur non valide ; Par exemple, une valeur de taille n’a pas été fournie pour une mémoire tampon non NULL. Il s’agit d’un code d’erreur.
STATUS_NOT_FOUND	Une identité de package n’existe pas.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
d’en-tête	ntifs.h

Voir aussi

RtlQueryPackageIdentityEx

Partager via