Funzione GetPackageInfo2 (appmodel.h)

Articolo
02/26/2024

Ottiene le informazioni sul pacchetto per il pacchetto specificato, con l'opzione per specificare il tipo di percorso della cartella da recuperare per il pacchetto.

Sintassi

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

Parametri

packageInfoReference

Tipo: PACKAGE_INFO_REFERENCE

Riferimento alle informazioni sul pacchetto.

flags

Tipo: const UINT32

Costanti del pacchetto che specificano la modalità di recupero delle informazioni sul pacchetto.

packagePathType

Tipo: PackagePathType

Indica il tipo di percorso della cartella da recuperare per il pacchetto (la cartella di installazione originale o la cartella modificabile).

bufferLength

Tipo: UINT32*

In input, le dimensioni del buffer, in byte. Nell'output, le dimensioni delle informazioni sul pacchetto restituite, in byte.

buffer

Tipo: BYTE*

Informazioni sul pacchetto, rappresentate come matrice di strutture PACKAGE_INFO .

count

Tipo: UINT32*

Numero di pacchetti nel buffer.

Valore restituito

Tipo: LONG

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore. I codici di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Il buffer non è sufficientemente grande da contenere i dati. Le dimensioni necessarie sono specificate da bufferLength.

Commenti

Il parametro packagePathType è utile per le applicazioni che usano l'estensione windows.mutablePackageDirectories nel manifesto del pacchetto. Questa estensione specifica una cartella nel percorso %ProgramFiles%\ModificafiableWindowsApps in cui vengono proiettati i contenuti della cartella di installazione dell'applicazione in modo che gli utenti possano modificare i file di installazione. Questa funzionalità è attualmente disponibile solo per determinati tipi di giochi per PC desktop pubblicati da Microsoft e dai nostri partner e consente a questi tipi di giochi di supportare i mod.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	appmodel.h
Libreria	Kernel32.lib
DLL	Kernel32.dll