Funzione GetCurrentPackageInfo2 (appmodel.h)

Articolo
02/23/2024

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

Sintassi

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Parametri

flags

Tipo: const UINT32

Costanti del pacchetto che specificano la modalità di recupero delle informazioni sul pacchetto. Sono supportati i flag PACKAGE_FILTER_* .

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 della matrice di strutture restituite, in byte.

buffer

Tipo: BYTE*

Informazioni sul pacchetto, rappresentate come matrice di strutture PACKAGE_INFO .

count

Tipo: UINT32*

Numero di strutture 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
APPMODEL_ERROR_NO_PACKAGE	Il processo non ha un'identità del pacchetto.
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