Share via

Funzione GetStagedPackagePathByFullName2 (appmodel.h)

  • Articolo

Ottiene il percorso del pacchetto a fasi specificato, con l'opzione per specificare il tipo di percorso della cartella da recuperare per il pacchetto.

Sintassi

LONG GetStagedPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parametri

packageFullName

Tipo: PCWSTR

Nome completo del pacchetto a fasi.

packagePathType

Tipo: PackagePathType

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

pathLength

Tipo: UINT32*

Puntatore a una variabile che contiene il numero di caratteri (WCHARs) nella stringa del percorso del pacchetto, che include il carattere null-terminatore.

Prima di tutto si passa NULL al percorso per ottenere il numero di caratteri. Questo numero viene usato per allocare lo spazio di memoria per il percorso. Passare quindi l'indirizzo di questo spazio di memoria per riempire il percorso.

path

Tipo: PWSTR

Puntatore allo spazio di memoria che riceve la stringa del percorso del pacchetto, che include il terminatore null.

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 specificato dal percorso non è sufficiente per contenere i dati. Le dimensioni necessarie sono specificate da pathLength.

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 il contenuto della cartella di installazione dell'applicazione viene proiettato in modo che gli utenti possano modificare i file di installazione. Questa funzionalità è attualmente disponibile solo per determinati tipi di giochi 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

Vedere anche

GetStagedPackagePathByFullName