Fonction RtlQueryPackageIdentityEx (ntifs.h)
RtlQueryPackageIdentityEx retourne le nom complet du package associé. Elle peut également retourner le nom de l’application relative du package et indiquer si une application est considérée comme empaquetée.
Syntaxe
NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
PVOID TokenObject,
PWSTR PackageFullName,
PSIZE_T PackageSize,
PWSTR AppId,
PSIZE_T AppIdSize,
LPGUID DynamicId,
PULONG64 Flags
);
Paramètres
TokenObject
Gérez un objet de jeton (mode utilisateur) qui a été ouvert avec un accès TOKEN_QUERY, 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 sera terminée par la valeur 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. Lors de la sortie, elle contient 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. Lors de la sortie, elle contient 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 avoir la valeur NULL.
DynamicId
Pointeur vers une valeur qui reçoit un ID dynamique pour l’application. DynamicId est facultatif et peut être NULL.
Flags
Pointeur vers une valeur qui reçoit un masque de bits de valeurs pour l’attribut de package.
Valeur retournée
RtlQueryPackageIdentityEx retourne STATUS_SUCCESS en cas de réussite de l’exécution ; 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, aucune valeur de taille n’a été fournie pour une mémoire tampon non NULL. Il s’agit d’un code d’erreur. |
STATUS_NOT_FOUND | Il n’existe pas d’identité de package. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8.1 |
En-tête | ntifs.h |