Funzione GetPackagePathByFullName2 (appmodel.h)

Articolo
08/22/2023

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

Sintassi

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

Parametri

packageFullName

Tipo: PCWSTR

Nome completo del 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).

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 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 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 dal percorso non è sufficientemente grande da contenere i dati. La dimensione richiesta viene specificata 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 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	KernelBase.dll

Vedi anche

GetPackagePathByFullName

Condividi tramite