Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |