Funzione GetStagedPackagePathByFullName2 (appmodel.h)

Articolo
03/05/2025

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 di staging.

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 di terminazione Null.

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

path

Tipo: PWSTR

Puntatore allo spazio di memoria che riceve la stringa del percorso del pacchetto, che include il carattere di terminazione 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 da percorso non è sufficientemente grande da contenere i dati. La dimensione richiesta viene specificata da pathLength.

Osservazioni

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%\ModifiableWindowsApps 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 per PC desktop pubblicati da Microsoft e dai nostri partner e consente a questi tipi di giochi di supportare mod.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 [solo app desktop]
server minimo supportato	Windows Server 2016 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	appmodel.h
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

GetStagedPackagePathByFullName

Condividi tramite