Função FormatApplicationUserModelId (appmodel.h)
Constrói uma ID de modelo de usuário do aplicativo com base no nome da família de pacotes e na PRAID ( ID relativa do aplicativo do pacote ).
Sintaxe
LONG FormatApplicationUserModelId(
[in] PCWSTR packageFamilyName,
[in] PCWSTR packageRelativeApplicationId,
[in, out] UINT32 *applicationUserModelIdLength,
[out, optional] PWSTR applicationUserModelId
);
Parâmetros
[in] packageFamilyName
Tipo: PCWSTR
O nome da família do pacote.
[in] packageRelativeApplicationId
Tipo: PCWSTR
A PRAID (ID do aplicativo relativo ao pacote).
[in, out] applicationUserModelIdLength
Tipo: UINT32*
Um ponteiro para uma variável que contém o número de caracteres (WCHARs) na cadeia de caracteres de ID do modelo de usuário do aplicativo, que inclui o terminador nulo.
Primeiro, você passa NULL para applicationUserModelId para obter o número de caracteres. Você usa esse número para alocar espaço de memória para applicationUserModelId. Em seguida, você passa o endereço desse espaço de memória para preencher applicationUserModelId.
[out, optional] applicationUserModelId
Tipo: PWSTR
Um ponteiro para o espaço de memória que recebe a cadeia de caracteres de ID do modelo de usuário do aplicativo, que inclui o terminador nulo.
Retornar valor
Tipo: LONG
Se a função for bem-sucedida , ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro. Os códigos de erro possíveis incluem o seguinte.
Código de retorno | Descrição |
---|---|
|
O parâmetro packageFamilyName ou packageRelativeApplicationId não é válido. |
|
O buffer especificado por applicationUserModelId não é grande o suficiente para manter os dados; o tamanho do buffer necessário, em WCHARs, é armazenado na variável apontada por applicationUserModelIdLength. |
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | appmodel.h |
Biblioteca | Kernel32.lib |
DLL | Kernel32.dll |