Funzione ParseApplicationUserModelId (appmodel.h)

Articolo
08/22/2023

Decostruisce un ID modello utente dell'applicazione in base al nome della famiglia di pacchetti e all'ID applicazione relativo al pacchetto (PRAID).

Sintassi

LONG ParseApplicationUserModelId(
  [in]            PCWSTR applicationUserModelId,
  [in, out]       UINT32 *packageFamilyNameLength,
  [out, optional] PWSTR  packageFamilyName,
  [in, out]       UINT32 *packageRelativeApplicationIdLength,
  [out, optional] PWSTR  packageRelativeApplicationId
);

Parametri

[in] applicationUserModelId

Tipo: PCWSTR

ID modello utente dell'app.

[in, out] packageFamilyNameLength

Tipo: UINT32*

Puntatore a una variabile che contiene il numero di caratteri (WCHARs) nella stringa del nome della famiglia di pacchetti, che include il carattere di terminazione Null.

Per prima cosa si passa NULL a packageFamilyName per ottenere il numero di caratteri. Questo numero viene usato per allocare spazio di memoria per packageFamilyName. Passare quindi l'indirizzo di questo spazio di memoria per riempire packageFamilyName.

[out, optional] packageFamilyName

Tipo: PWSTR

Puntatore allo spazio di memoria che riceve la stringa del nome della famiglia di pacchetti, che include il carattere di terminazione Null.

[in, out] packageRelativeApplicationIdLength

Tipo: UINT32*

Puntatore a una variabile che contiene il numero di caratteri (WCHARs) nella stringa ID app relativa al pacchetto, che include il carattere di terminazione Null.

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

[out, optional] packageRelativeApplicationId

Tipo: PWSTR

Puntatore allo spazio di memoria che riceve la stringa PRAID (Package-Relative App ID), che include il terminatore 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 applicationUserModelId non è valido.
ERROR_INSUFFICIENT_BUFFER	Il buffer specificato da packageFamilyName o packageRelativeApplicationId non è sufficientemente grande da contenere i dati; le dimensioni del buffer necessarie, in WCHARs, vengono archiviate nella variabile a cui punta packageFamilyNameLength o packageRelativeApplicationIdLength.

Requisiti


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