Compartilhar via


Função GetCurrentApplicationUserModelId (appmodel.h)

Obtém a ID do modelo de usuário do aplicativo para o processo atual.

Sintaxe

LONG GetCurrentApplicationUserModelId(
  [in, out] UINT32 *applicationUserModelIdLength,
  [out]     PWSTR  applicationUserModelId
);

Parâmetros

[in, out] applicationUserModelIdLength

Na entrada, o tamanho do buffer applicationUserModelId , em caracteres largos. Em caso de êxito, o tamanho do buffer usado, incluindo o terminador nulo.

[out] applicationUserModelId

Um ponteiro para um buffer que recebe a ID do modelo de usuário do aplicativo.

Retornar valor

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
APPMODEL_ERROR_NO_APPLICATION
O processo não tem nenhuma identidade de aplicativo.
ERROR_INSUFFICIENT_BUFFER
O buffer não é grande o suficiente para manter os dados. O tamanho necessário é especificado por applicationUserModelIdLength.

Comentários

Para obter informações sobre limites de tamanho de cadeia de caracteres, consulte Constantes de identidade.

Exemplos

#define _UNICODE 1
#define UNICODE 1

#include <Windows.h>
#include <appmodel.h>
#include <malloc.h>
#include <stdio.h>

int __cdecl wmain()
{
    UINT32 length = 0;
    LONG rc = GetCurrentApplicationUserModelId(&length, NULL);
    if (rc != ERROR_INSUFFICIENT_BUFFER)
    {
        if (rc == APPMODEL_ERROR_NO_APPLICATION)
            wprintf(L"Desktop application\n");
        else
            wprintf(L"Error %d in GetCurrentApplicationUserModelId\n", rc);
        return 1;
    }

    PWSTR fullName = (PWSTR) malloc(length * sizeof(*fullName));
    if (fullName == NULL)
    {
        wprintf(L"Error allocating memory\n");
        return 2;
    }

    rc = GetCurrentApplicationUserModelId(&length, fullName);
    if (rc != ERROR_SUCCESS)
    {
        wprintf(L"Error %d retrieving ApplicationUserModelId\n", rc);
        return 3;
    }
    wprintf(L"%s\n", fullName);

    free(fullName);

    return 0;
}

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho appmodel.h
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetApplicationUserModelId

GetCurrentPackageFullName