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
ERROR_INVALID_PARAMETER
Il parametro packageFamilyName o packageRelativeApplicationId non è valido.
ERROR_INSUFFICIENT_BUFFER
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