Função ParseApplicationUserModelId (appmodel.h)
Desconstrói uma ID de modelo de usuário do aplicativo para o nome da família de pacotes e a PRAID ( ID do aplicativo relativo do pacote ).
Sintaxe
LONG ParseApplicationUserModelId(
[in] PCWSTR applicationUserModelId,
[in, out] UINT32 *packageFamilyNameLength,
[out, optional] PWSTR packageFamilyName,
[in, out] UINT32 *packageRelativeApplicationIdLength,
[out, optional] PWSTR packageRelativeApplicationId
);
Parâmetros
[in] applicationUserModelId
Tipo: PCWSTR
A ID do modelo de usuário do aplicativo.
[in, out] packageFamilyNameLength
Tipo: UINT32*
Um ponteiro para uma variável que contém o número de caracteres (WCHARs) na cadeia de caracteres de nome da família de pacotes, que inclui o terminador nulo.
Primeiro, você passa NULL para packageFamilyName para obter o número de caracteres. Use esse número para alocar espaço de memória para packageFamilyName. Em seguida, você passa o endereço desse espaço de memória para preencher packageFamilyName.
[out, optional] packageFamilyName
Tipo: PWSTR
Um ponteiro para o espaço de memória que recebe a cadeia de caracteres de nome da família de pacotes, que inclui o terminador nulo.
[in, out] packageRelativeApplicationIdLength
Tipo: UINT32*
Um ponteiro para uma variável que contém o número de caracteres (WCHARs) na cadeia de caracteres de ID do aplicativo relativa ao pacote, que inclui o terminador nulo.
Primeiro, você passa NULL para packageRelativeApplicationId para obter o número de caracteres. Use esse número para alocar espaço de memória para packageRelativeApplicationId. Em seguida, você passa o endereço desse espaço de memória para preencher packageRelativeApplicationId.
[out, optional] packageRelativeApplicationId
Tipo: PWSTR
Um ponteiro para o espaço de memória que recebe a cadeia de caracteres PRAID (ID do aplicativo relativo ao pacote), que inclui o terminador nulo.
Valor retornado
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 applicationUserModelId não é válido. |
|
O buffer especificado por packageFamilyName ou packageRelativeApplicationId não é grande o suficiente para armazenar os dados; o tamanho do buffer necessário, em WCHARs, é armazenado na variável apontada por packageFamilyNameLength ou packageRelativeApplicationIdLength. |
Requisitos
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 |