Funzione RtlQueryPackageIdentity (ntifs.h)

  • Articolo

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

Vedi anche

RtlQueryPackageIdentityEx