Funzione FormatApplicationUserModelId (appmodel.h)
Costruisce un ID modello utente dell'applicazione dal nome della famiglia di pacchetti e dall'ID applicazione relativo al pacchetto (PRAID).
Sintassi
LONG FormatApplicationUserModelId(
[in] PCWSTR packageFamilyName,
[in] PCWSTR packageRelativeApplicationId,
[in, out] UINT32 *applicationUserModelIdLength,
[out, optional] PWSTR applicationUserModelId
);
Parametri
[in] packageFamilyName
Tipo: PCWSTR
Nome della famiglia di pacchetti.
[in] packageRelativeApplicationId
Tipo: PCWSTR
ID app relativo al pacchetto (PRAID).
[in, out] applicationUserModelIdLength
Tipo: UINT32*
Puntatore a una variabile che contiene il numero di caratteri (WCHARs) nella stringa id modello utente dell'app, che include il carattere di terminazione Null.
Prima di tutto si passa NULL a applicationUserModelId per ottenere il numero di caratteri. Questo numero viene usato per allocare spazio di memoria per applicationUserModelId. Passare quindi l'indirizzo di questo spazio di memoria per riempire applicationUserModelId.
[out, optional] applicationUserModelId
Tipo: PWSTR
Puntatore allo spazio di memoria che riceve la stringa ID modello utente dell'app, 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 |
---|---|
|
Il parametro packageFamilyName o packageRelativeApplicationId non è valido. |
|
Il buffer specificato da applicationUserModelId non è sufficientemente grande da contenere i dati; le dimensioni del buffer necessarie, in WCHARs, vengono archiviate nella variabile a cui punta applicationUserModelIdLength. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8.1 [app desktop | App UWP] |
Server minimo supportato | Windows Server 2012 R2 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | appmodel.h |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |