Funzione RtlQueryPackageIdentity (ntifs.h)
RtlQueryPackageIdentity restituisce il nome completo del pacchetto associato. Facoltativamente, può restituire anche il nome dell'applicazione relativa al pacchetto e se un'applicazione viene considerata in pacchetto. Vedere anche RtlQueryPackageIdentityEx.
Sintassi
NTSYSAPI NTSTATUS RtlQueryPackageIdentity(
PVOID TokenObject,
PWSTR PackageFullName,
PSIZE_T PackageSize,
PWSTR AppId,
PSIZE_T AppIdSize,
PBOOLEAN Packaged
);
Parametri
TokenObject
Gestire un oggetto token (modalità utente) aperto con l'accesso TOKEN_QUERY o a un oggetto token non elaborato (modalità kernel).
PackageFullName
Puntatore a un buffer di caratteri wide che riceverà la chiave univoca del pacchetto. Il buffer verrà terminato null al termine dell'esito positivo.
PackageSize
Puntatore al valore che definisce le dimensioni del buffer a cui PackageFullName punta. Nell'output, conterrà le dimensioni scritte, incluso il valore null di terminazione.
AppId
Puntatore a un buffer di caratteri wide che può ricevere l'identificatore dell'applicazione relativo al pacchetto. AppId è facoltativo e può essere NULL.
AppIdSize
Puntatore al valore che definisce le dimensioni del buffer a cui AppId punta. Nell'output, conterrà le dimensioni scritte, incluso il valore null di terminazione. Se AppId non è NULL, AppIdSize deve puntare a un valore valido; In caso contrario , AppIdSize deve essere impostato su NULL.
Packaged
Puntatore a un valore che riceve un flag BOOLEAN che indica se l'applicazione è in pacchetto. Il pacchetto è facoltativo e può essere NULL.
Valore restituito
RtlQueryPackageIdentity restituisce STATUS_SUCCESS al completamento positivo; in caso contrario, restituisce un codice come uno dei seguenti.
Codice di errore | Significato |
---|---|
STATUS_INVALID_PARAMETER | Un parametro contiene un valore non valido; ad esempio, un valore di dimensione non è stato fornito per un buffer non NULL. Si tratta di un codice di errore. |
STATUS_NOT_FOUND | Un'identità del pacchetto non esiste. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 |
Intestazione | ntifs.h |