Funzione FormatApplicationUserModelId (appmodel.h)

Articolo
02/28/2024

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

Share via