Funzione RtlQueryPackageIdentityEx (ntifs.h)

  • Articolo

RtlQueryPackageIdentityEx restituisce il nome completo del pacchetto associato. Può anche restituire il nome dell'applicazione relativa al pacchetto e se un'applicazione viene considerata in pacchetto.

Sintassi

NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  LPGUID   DynamicId,
  PULONG64 Flags
);

Parametri

TokenObject

Gestire un oggetto token (modalità utente) aperto con 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 in caso di esito positivo.

PackageSize

Puntatore al valore che definisce le dimensioni del buffer a cui punta PackageFullName . 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 relativa del pacchetto. AppId è facoltativo e può essere NULL.

AppIdSize

Puntatore al valore che definisce le dimensioni del buffer a cui punta AppId . 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.

DynamicId

Puntatore a un valore che riceve un ID dinamico per l'applicazione. DynamicId è facoltativo e può essere NULL.

Flags

Puntatore a un valore che riceve una maschera di bit di valori per l'attributo del pacchetto.

Valore restituito

RtlQueryPackageIdentityEx restituisce STATUS_SUCCESS al completamento; in caso contrario, restituisce un codice, ad esempio uno dei seguenti.

Codice di errore Significato
STATUS_INVALID_PARAMETER Un parametro contiene un valore non valido; Ad esempio, non è stato specificato un valore di dimensione 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.1
Intestazione ntifs.h